ECMA-262 草案 / 2025年5月19日
ECMAScript® 2026 语言规范
关于本规范
位于 https://tc39.es/ecma262/ 的文档是最准确和最新的 ECMAScript 规范。它包含最新年度快照的内容以及自该快照以来的所有 已完成提案 （那些在 提案流程 中达到第4阶段的提案，因此已在多个实现中实现，将包含在下一个实际修订版中）。
为本规范做贡献
本规范在 GitHub 上借助 ECMAScript 社区的帮助进行开发。有多种方式可以为本规范的开发做出贡献：
- GitHub 仓库：https://github.com/tc39/ecma262
- 问题：所有问题，提交新问题
- 拉取请求：所有拉取请求，创建新拉取请求
- 测试套件：Test262
- 编辑：
-
社区：
- 讨论：https://es.discourse.group/
- 聊天：Matrix
- 邮件
列表 存档：https://esdiscuss.org/
有关本文档创建方式的更多信息，请参阅
介绍
本 Ecma 标准定义了 ECMAScript 2026 语言。这是 ECMAScript 语言规范的第十七版。自 1997 年第一版发布以来，ECMAScript 已经发展成为世界上最广泛使用的通用编程语言之一。它最为人所知的是作为嵌入在 Web 浏览器中的语言，但也被广泛应用于服务器和嵌入式应用程序。
ECMAScript 基于几种原创技术，最著名的是 JavaScript（Netscape）和 JScript（Microsoft）。该语言由 Brendan Eich 在 Netscape 发明，首次出现在该公司的 Navigator 2.0 浏览器中。它出现在 Netscape 的所有后续浏览器中，以及从 Internet Explorer 3.0 开始的所有 Microsoft 浏览器中。
ECMAScript 语言规范的开发始于 1996 年 11 月。本 Ecma 标准的第一版于 1997 年 6 月由 Ecma 大会通过。
该 Ecma 标准已提交给 ISO/IEC JTC 1，按照快速通道程序通过，并于 1998 年 4 月批准为国际标准 ISO/IEC 16262。1998 年 6 月的 Ecma 大会批准了 ECMA-262 的第二版，以保持与 ISO/IEC 16262 完全一致。第一版和第二版之间的变化在性质上是编辑性的。
该标准的第三版引入了强大的正则表达式、更好的字符串处理、新的控制语句、try/catch 异常处理、更严格的错误定义、数值输出格式化以及为预期的未来语言增长而进行的小幅更改。ECMAScript 标准的第三版于 1999 年 12 月由 Ecma 大会通过，并于 2002 年 6 月作为 ISO/IEC 16262:2002 发布。
第三版发布后，ECMAScript 与万维网结合实现了大规模应用，成为几乎所有 Web 浏览器支持的编程语言。为开发 ECMAScript 第四版做了大量工作。然而，这项工作没有完成，也没有作为 ECMAScript 第四版发布，但其中一些内容被纳入了第六版的开发中。
ECMAScript 第五版（作为 ECMA-262 第 5 版发布）编纂了在浏览器实现中已经常见的语言规范的事实解释，并增加了对自第三版发布以来出现的新功能的支持。这些功能包括
第五版已提交给 ISO/IEC JTC 1，按照快速通道程序通过，并批准为国际标准 ISO/IEC 16262:2011。ECMAScript 标准的 5.1 版纳入了小幅更正，与 ISO/IEC 16262:2011 文本相同。5.1 版于 2011 年 6 月由 Ecma 大会通过。
第六版的重点开发始于 2009 年，当时第五版正在准备发布。然而，这之前进行了大量的实验和语言增强设计工作，可以追溯到 1999
年第三版的发布。从很真实的意义上说，第六版的完成是十五年努力的顶峰。这一版的目标包括为大型应用程序、库创建以及将 ECMAScript
用作其他语言的编译目标提供更好的支持。它的一些主要增强功能包括模块、类声明、词法块作用域、
ECMAScript 2016 是在 Ecma TC39 新的年度发布节奏和开放开发过程下发布的第一个 ECMAScript 版本。从 ECMAScript 2015 源文档构建了一个纯文本源文档，作为完全在
GitHub 上进一步开发的基础。在这个标准开发的一年中，提交了数百个拉取请求和问题，代表了数千个错误修复、编辑修复和其他改进。此外，还开发了许多软件工具来帮助这一工作，包括
Ecmarkup、Ecmarkdown 和 Grammarkdown。ES2016 还包括对新指数运算符的支持，并向 Array.prototype 添加了一个名为
includes 的新方法。
ECMAScript 2017 引入了异步函数、共享内存和原子操作，以及较小的语言和库增强、错误修复和编辑更新。异步函数通过为返回 promise
的函数提供语法来改善异步编程体验。共享内存和原子操作引入了新的Object.values、Object.entries 和
Object.getOwnPropertyDescriptors。
ECMAScript 2018 通过dotAll
标志、命名捕获组、Unicode 属性转义和后行断言。最后，它包括对象 rest 和展开属性。
ECMAScript 2019 引入了一些新的内置函数：Array.prototype 上用于扁平化数组的 flat 和
flatMap，用于直接将 Object.entries 的返回值转换为新 Object 的
Object.fromEntries，以及 String.prototype 上的 trimStart 和
trimEnd，作为广泛实现但非标准的 String.prototype.trimLeft 和 trimRight
内置功能的更好命名替代品。此外，它还包括语法和语义的一些小更新。更新的语法包括可选的 catch 绑定参数，以及允许在字符串字面量中使用 U+2028（行分隔符）和 U+2029（段落分隔符）以与 JSON
保持一致。其他更新包括要求 Array.prototype.sort 为稳定排序，要求 JSON.stringify 无论输入如何都返回格式良好的
UTF-8，以及通过要求它返回相应的原始源文本或标准占位符来澄清 Function.prototype.toString。
ECMAScript 2020，第 11 版，为字符串引入了 matchAll 方法，为全局正则表达式生成的所有匹配对象产生一个import()，一种使用动态说明符异步导入模块的语法；BigInt，用于处理任意精度Promise.allSettled，一个不会短路的新 Promise
组合器；globalThis，访问全局 this 值的通用方式；专用的 export * as ns from 'module'
语法，用于在模块内使用；增加了 for-in 枚举顺序的标准化；import.meta，一个在模块中可用的
ECMAScript 2021，第 12 版，为字符串引入了 replaceAll 方法；Promise.any，一个在输入值被满足时短路的 Promise
组合器；AggregateError，一个同时表示多个错误的新 Error
类型；逻辑赋值运算符（??=、&&=、||=）；WeakRef，用于引用目标对象而不阻止其被垃圾回收，以及
FinalizationRegistry，用于管理目标对象被垃圾回收时执行的清理操作的注册和注销；数字字面量的分隔符（1_000）；以及
Array.prototype.sort 变得更加精确，减少了导致
ECMAScript 2022，第 13 版，引入了顶级 await，允许在模块顶级使用该#x in obj
语法，用于测试对象上私有字段的存在；通过 /d 标志的正则表达式匹配索引，提供匹配子字符串的开始和结束索引；Error 对象上的
cause 属性，可用于在错误中记录因果链；字符串、数组和 at 方法，允许相对索引；以及
Object.hasOwn，Object.prototype.hasOwnProperty 的便捷替代品。
ECMAScript 2023，第 14 版，在 Array.prototype 和 TypedArray.prototype 上引入了
toSorted、toReversed、with、findLast 和
findLastIndex 方法，以及 Array.prototype 上的 toSpliced 方法；增加了对文件开头
#! 注释的支持，以更好地促进可执行的 ECMAScript 文件；并允许在弱集合中使用大多数 Symbol 作为键。
ECMAScript 2024，第 15 版，增加了调整大小和传输 ArrayBuffer 和 SharedArrayBuffer 的功能；增加了新的 RegExp /v
标志，用于创建具有更高级功能的 RegExp 以处理字符串集合；并引入了用于构造 Promise 的 Promise.withResolvers 便捷方法，用于聚合数据的
Object.groupBy 和 Map.groupBy 方法，用于异步等待共享内存更改的 Atomics.waitAsync
方法，以及用于检查和确保字符串仅包含格式良好的 Unicode 的 String.prototype.isWellFormed 和
String.prototype.toWellFormed 方法。
ECMAScript 2025，第 16 版，添加了一个新的 Iterator 全局对象，带有相关的静态和原型方法，用于处理Set.prototype 添加了用于对 Set 执行常见操作的方法；增加了对导入 JSON 模块的支持以及用于声明导入模块属性的语法；添加了用于转义字符串以在正则表达式中安全使用的
RegExp.escape 方法；添加了用于在正则表达式内内联启用和禁用修饰符标志的语法；添加了用于调用可能返回或可能不返回 Promise
的函数并确保结果始终为 Promise 的 Promise.try 方法；并添加了新的 Float16Array
DataView.prototype.getFloat16、DataView.prototype.setFloat16 和
Math.f16round 方法。
代表众多组织的数十名个人在 Ecma TC39 内对本版本和以前版本的开发做出了非常重要的贡献。此外，已经形成了一个充满活力的社区来支持 TC39 的 ECMAScript 工作。这个社区审查了许多草案，提交了数千个错误报告，进行了实现实验，贡献了测试套件，并向全球开发者社区介绍了 ECMAScript。不幸的是，无法识别和承认每个为这一努力做出贡献的个人和组织。
Allen Wirfs-Brock
ECMA-262，项目编辑，第 6 版
Brian Terlson
ECMA-262，项目编辑，第 7 至第 10 版
Jordan Harband
ECMA-262，项目编辑，第 10 至第 12 版
Shu-yu Guo
ECMA-262，项目编辑，第 12 至第 16 版
Michael Ficarra
ECMA-262，项目编辑，第 12 至第 16 版
Kevin Gibbons
ECMA-262，项目编辑，第 12 至第 16 版
1 范围
本标准定义了 ECMAScript 2026 通用编程语言。
2 一致性
ECMAScript 的一致性实现必须提供并支持本规范中描述的所有类型、值、对象、属性、函数以及程序语法和语义。
ECMAScript 的一致性实现必须按照最新版本的 Unicode 标准和 ISO/IEC 10646 来解释源文本输入。
提供应用程序编程接口 (API) 的 ECMAScript 一致性实现，如果该 API 支持需要适应不同人类语言和国家使用的语言和文化约定的程序，则必须实现与本规范兼容的最新版本 ECMA-402 中定义的接口。
ECMAScript 的一致性实现可以提供本规范中描述的类型、值、对象、属性和函数之外的其他类型、值、对象、属性和函数。特别是，ECMAScript 的一致性实现可以为本规范中描述的对象提供本规范中未描述的属性以及这些属性的值。
ECMAScript 的一致性实现可以支持本规范中未描述的程序和正则表达式语法。特别是，ECMAScript 的一致性实现可以支持使用本规范子条款
ECMAScript 的一致性实现不得实现子条款
ECMAScript 的一致性实现不得重新定义任何不是
ECMAScript 的一致性实现可以选择实现或不实现规范可选子条款。如果实现了任何规范可选行为，则必须实现包含规范可选条款中的所有行为。规范可选条款在本规范中用彩色框中的"规范可选"字样表示，如下所示。
2.1 示例规范可选条款标题
示例条款内容。
ECMAScript 的一致性实现必须实现遗留子条款，除非它们也被标记为规范可选。遗留子条款中指定的所有语言功能和行为都具有一个或多个不良特征。然而，它们在现有应用程序中的持续使用阻止了它们从本规范中被移除。这些功能不被视为核心 ECMAScript 语言的一部分。程序员在编写新的 ECMAScript 代码时不应使用或假设这些功能和行为的存在。
2.2 示例遗留条款标题
示例条款内容。
2.3 示例遗留规范可选条款标题
示例条款内容。
3 规范性引用
以下引用文档对于本文档的应用是必不可少的。对于注明日期的引用，只适用所引用的版本。对于未注明日期的引用，适用引用文档的最新版本（包括任何修订）。
Unicode 标准。
https://unicode.org/versions/latest
ISO/IEC 10646，信息技术 — 通用多八位编码字符集 (UCS) 加上修订 1:2005、修订 2:2006、修订 3:2008、修订 4:2008，以及其他修订和勘误，或后续版本。
ECMA-402，ECMAScript 国际化 API 规范，特指与本规范版本对应的年度版本。
https://www.ecma-international.org/publications-and-standards/standards/ecma-402/
ECMA-404，JSON 数据交换格式。
https://www.ecma-international.org/publications-and-standards/standards/ecma-404/
4 概述
本节包含对 ECMAScript 语言的非规范性概述。
ECMAScript 是一种面向对象的编程语言，用于在
ECMAScript
最初被设计用作脚本语言，但现已广泛用作通用编程语言。脚本语言是一种编程语言，用于操作、自定义和自动化现有系统的设施。在这样的系统中，有用的功能已经通过用户界面可用，脚本语言是将该功能暴露给程序控制的机制。通过这种方式，现有系统被称为提供对象和设施的
ECMAScript 最初被设计为Web 脚本语言，提供在浏览器中活跃网页并作为基于 Web 的客户端-服务器架构的一部分执行服务器计算的机制。ECMAScript
现在用于为各种
ECMAScript 的使用已经超越了简单的脚本编写，现在用于许多不同环境和规模中编程任务的全谱。随着 ECMAScript 使用的扩展，它提供的功能和设施也在扩展。ECMAScript 现在是一种功能齐全的通用编程语言。
4.1 Web 脚本
Web 浏览器为客户端计算提供 ECMAScript
Web 服务器为服务器端计算提供不同的
每个支持 ECMAScript 的 Web 浏览器和服务器都提供自己的
4.2 宿主和实现
为了帮助将 ECMAScript 集成到
实现是进一步定义附录
实现定义设施是将其定义推迟到外部来源而无需进一步限定的设施。本规范不对特定行为提出任何建议，符合规范的实现可以在本规范提出的约束内自由选择任何行为。
实现近似设施是将其定义推迟到外部来源同时推荐理想行为的设施。虽然符合规范的实现可以在本规范提出的约束内自由选择任何行为，但鼓励它们努力接近理想。某些数学运算，如Math.exp
宿主是进一步定义附录
宿主钩子是全部或部分由外部来源定义的抽象操作。所有
宿主定义设施是将其定义推迟到外部来源而无需进一步限定并在附录
宿主环境是对所有
4.3 ECMAScript 概述
以下是 ECMAScript 的非正式概述——并非语言的所有部分都被描述。这个概述不是标准本身的一部分。
ECMAScript 是基于对象的：基本语言和
ECMAScript 定义了一个内置对象集合，完善了 ECMAScript 实体的定义。这些内置对象包括Object、Function、Boolean、Symbol 和各种
Error 对象；表示和操作数值的对象，包括 Math、Number 和
Date；文本处理对象 String 和 RegExp；作为值的索引集合的对象，包括
Array 和九种不同类型的类型化数组，其元素都有特定的数值数据表示；键值集合，包括 Map 和
Set 对象；支持结构化数据的对象，包括 JSON
对象、ArrayBuffer、SharedArrayBuffer
和 DataView；支持控制抽象的对象，包括生成器函数和 Promise 对象；以及反射对象，包括
Proxy 和 Reflect。
ECMAScript 还定义了一组内置操作符。ECMAScript 操作符包括各种一元运算、乘性运算符、加性运算符、按位移位运算符、关系运算符、相等运算符、二元按位运算符、二元逻辑运算符、赋值运算符和逗号运算符。
大型 ECMAScript 程序由模块支持，模块允许程序被分为多个语句和声明序列。每个模块明确标识它使用的需要由其他模块提供的声明，以及它的哪些声明可供其他模块使用。
ECMAScript 语法有意类似 Java 语法。ECMAScript 语法被放宽以使其能够作为易于使用的脚本语言。例如，变量不需要声明其类型，类型也不与属性关联，定义的函数不需要在调用之前在文本上出现其声明。
4.3.1 对象
尽管 ECMAScript 包含类定义的语法，但 ECMAScript 对象在根本上不是基于类的，如 C++、Smalltalk 或 Java
中的对象。相反，对象可以通过各种方式创建，包括通过字面量表示法或通过new Date(2009, 11) 创建一个新的
Date 对象。在不使用 new 的情况下调用Date()
产生当前日期和时间的字符串表示，而不是对象。
每个由
在基于类的面向对象语言中，一般来说，状态由实例承载，方法由类承载，继承只是结构和行为的继承。在 ECMAScript 中，状态和方法由对象承载，而结构、行为和状态都被继承。
所有不直接包含其原型包含的特定属性的对象都共享该属性及其值。图 1 说明了这一点：
CF 是一个new
表达式创建了五个对象：cf1、cf2、cf3、cf4
和 cf5。这些对象中的每一个都包含名为
与大多数基于类的对象语言不同，可以通过为对象赋值来动态添加属性。也就是说，
虽然 ECMAScript 对象本质上不是基于类的，但基于
4.3.2 ECMAScript 的严格变体
ECMAScript 语言认识到一些语言用户可能希望限制使用语言中可用的某些功能的可能性。他们可能出于安全考虑、避免他们认为容易出错的功能、获得增强的错误检查或其他他们选择的原因而这样做。为了支持这种可能性，ECMAScript 定义了语言的严格变体。语言的严格变体排除了常规 ECMAScript 语言的一些特定语法和语义功能，并修改了一些功能的详细语义。严格变体还指定了必须通过在非严格形式的语言未指定为错误的情况下抛出错误异常来报告的额外错误条件。
ECMAScript 的严格变体通常被称为语言的严格模式。严格模式的选择和使用以及 ECMAScript 的严格模式语法和语义在个别
为了符合本规范，ECMAScript 实现必须实现完整的无限制 ECMAScript 语言和本规范定义的 ECMAScript 语言的严格变体。此外，实现必须支持将无限制和严格模式源文本单元组合到单个复合程序中。
4.4 术语和定义
就本文档而言，以下术语和定义适用。
4.4.1 实现近似
4.4.2 实现定义
4.4.3 宿主定义
与
编辑上，见条款
4.4.4 类型
如条款
4.4.5 原始值
Undefined、Null、Boolean、Number、BigInt、Symbol 或 String 类型之一的成员，如条款
原始值是在语言实现的最低级别直接表示的数据。
4.4.6 对象
Object 类型的成员
对象是属性的集合，并且有一个原型对象。原型可能是
4.4.7 构造函数
创建和初始化对象的
4.4.8 原型
为其他对象提供共享属性的对象
4.4.9 普通对象
对于所有对象必须支持的基本内部方法具有默认行为的对象
4.4.10 异质对象
对于一个或多个基本内部方法没有默认行为的对象
4.4.11 标准对象
语义由本规范定义的对象
4.4.12 内置对象
由 ECMAScript 实现指定和提供的对象
标准内置对象在本规范中定义。ECMAScript 实现可以指定和提供本规范中未描述的其他类型的内置对象。
4.4.13 undefined 值
在变量未被赋值时使用的原始值
4.4.14 Undefined 类型
唯一值为
4.4.15 null 值
表示故意缺少任何对象值的原始值
4.4.16 Null 类型
唯一值为
4.4.17 Boolean 值
只有两个 Boolean 值，
4.4.18 Boolean 类型
由原始值
4.4.19 Boolean 对象
Boolean 对象通过在 new 表达式中使用 Boolean
4.4.20 String 值
4.4.21 String 类型
所有可能 String 值的集合
4.4.22 String 对象
4.4.23 Number 值
对应于双精度 64 位二进制格式
Number 值是
4.4.24 Number 类型
所有可能 Number 值的集合，包括
4.4.25 Number 对象
4.4.26 Infinity
正无限 Number 值的 Number 值
4.4.27 NaN
4.4.28 BigInt 值
对应于任意精度
4.4.29 BigInt 类型
所有可能 BigInt 值的集合
4.4.30 BigInt 对象
4.4.31 Symbol 值
表示唯一、非 String 对象
4.4.32 Symbol 类型
所有可能 Symbol 值的集合
4.4.33 Symbol 对象
4.4.34 函数
除了其属性外，函数包含可执行代码和状态，这些决定了调用时的行为。函数的代码可能用 ECMAScript 编写，也可能不是。
4.4.35 内置函数
是函数的内置对象
内置函数的例子包括 parseInt 和 Math.exp。
4.4.36 内置构造函数
是
4.4.37 属性
对象的一部分，将键（String 值或 Symbol 值）与值关联
根据属性的形式，值可以直接表示为数据值（原始值、对象或
4.4.38 方法
作为属性值的函数
当函数作为对象的方法调用时，对象作为其
4.4.39 内置方法
是内置函数的方法
标准内置方法在本规范中定义。
4.4.40 特性
定义属性某些特征的内部值
4.4.41 自有属性
直接包含在其对象中的属性
4.4.42 继承属性
对象的属性，不是自有属性但是对象原型的属性（自有或继承）
4.5 本规范的组织结构
本规范的其余部分组织如下：
章节
章节
章节
章节
章节
5 记号约定
5.1 语法和词法文法
5.1.1 上下文无关文法
上下文无关文法由若干产生式组成。每个产生式的左侧有一个称为非终结符的抽象符号，右侧是零个或多个非终结符和终结符符号的序列。对于每个文法，终结符都从指定的字母表中选取。
链式产生式是在其右侧恰好有一个非终结符号以及零个或多个终结符的产生式。
从一个由单一特殊非终结符组成的句子开始，称为目标符号，给定的上下文无关文法指定一种语言，即，通过反复将序列中的任何非终结符替换为以该非终结符作为左侧的产生式的右侧，可能产生的终结符序列的（可能无限的）集合。
5.1.2 词法和 RegExp 文法
ECMAScript 的词法文法在
除空白和注释之外的输入元素构成了 ECMAScript 句法文法的终结符，并被称为 ECMAScript 标记。这些标记是 ECMAScript 语言的/*…*/ 的注释，无论其是否跨越多行）不包含行终止符，则同样会被简单丢弃；但如果
ECMAScript 的 RegExp 文法在章节
词法文法和 RegExp 文法的产生式以两个冒号"::"作为分隔标点符号来区分。词法文法和 RegExp 文法共享一些产生式。
5.1.3 数值字符串文法
数值字符串文法出现在章节
数值字符串文法的产生式以三个冒号":::"作为标点符号来区分，从不用于解析源文本。
5.1.4 语法文法
ECMAScript 的语法文法在章节
当代码点流要被解析为 ECMAScript
当解析成功时，它构造一个解析树，这是一个根树结构，其中每个节点都是一个解析节点。每个解析节点是文法中符号的一个实例；它表示可以从该符号派生的源文本范围。表示整个源文本的解析树根节点是解析的
为每次解析器调用实例化新的解析节点，即使是相同源文本的解析也从不重用。当且仅当解析节点表示相同的源文本范围、是相同文法符号的实例且来自相同的解析器调用时，才被认为是同一个解析节点。
多次解析相同的字符串将导致不同的解析节点。例如，考虑：
let str = "1 + 1;";
eval(str);
eval(str);每次调用 eval 都将 str 的值转换为
语法文法的产生式以仅一个冒号":"作为标点符号来区分。
章节
在某些情况下，为了避免歧义，语法文法使用广义产生式，允许不构成有效 ECMAScript
- 最初由 P 匹配的标记序列使用 N 作为
目标符号 重新解析。如果 N 接受文法参数，则设置为最初解析 P 时使用的相同值。 - 如果标记序列可以解析为 N 的单个实例且没有剩余标记，则：
- 我们将 N 的该实例（对于给定的 P 是唯一的解析节点）称为"被 P 覆盖的 N"。
- N 及其派生产生式的所有早期错误规则也适用于被 P 覆盖的 N。
- 否则（如果解析失败），这是早期语法错误。
5.1.5 文法符号
5.1.5.1 终结符号
在 ECMAScript 文法中，一些终结符号以 固定宽度 字体显示。
这些符号必须在源文本中完全按照所写的方式出现。以这种方式指定的所有终结符号代码点
都应理解为来自基本拉丁块的适当 Unicode 代码点，而不是来自其他 Unicode 范围的任何类似代码点。
终结符号中的代码点不能用 \
在终结符号为单个 Unicode 代码点的文法中（即词法、正则表达式和数字字符串文法）， 产生式中出现的多个连续固定宽度代码点是相同代码点序列的简写， 写作独立的终结符号。
例如，产生式：
是以下的简写：
相比之下，在语法文法中，连续的固定宽度代码点是单个终结符号。
终结符号有另外两种形式：
- 在词法和正则表达式文法中，没有常规打印表示的 Unicode 代码点
以 "<ABBREV>" 的形式显示，其中 "ABBREV" 是代码点或代码点集合的助记符。
这些形式在
Unicode 格式控制字符 、空白符 和行终止符 中定义。 - 在语法文法中，某些终结符号（例如
IdentifierName 和RegularExpressionLiteral ） 以斜体显示，因为它们引用词法文法中的同名非终结符。
5.1.5.2 非终结符号和产生式
非终结符号以 斜体 显示。非终结符的定义（也称为"产生式"） 由要定义的非终结符的名称后跟一个或多个冒号引入。（冒号的数量表示产生式属于哪个文法。） 然后在后续行中跟随非终结符的一个或多个可选右侧。例如，语法定义：
表示非终结符 while，后跟左括号 token，后跟
表示
5.1.5.3 可选符号
下标后缀 "opt" 可能出现在终结符或非终结符之后，表示可选符号。 包含可选符号的选择实际上指定了两个右侧，一个省略可选元素，一个包含它。这意味着：
是以下的便利缩写：
并且：
是以下的便利缩写：
这又是以下的缩写：
所以，在这个例子中，非终结符
5.1.5.4 文法参数
产生式可以通过下标注释的形式 "[parameters]" 进行参数化， 该注释可以作为产生式定义的非终结符号的后缀出现。"parameters" 可以是单个名称 或用逗号分隔的名称列表。参数化产生式是一组产生式的简写， 定义了参数名称的所有组合，在下划线前面，附加到参数化非终结符号。这意味着：
是以下的便利缩写：
并且：
是以下的缩写：
多个参数产生组合数量的产生式，并非所有这些产生式都必须在完整文法中引用。
产生式右侧的非终结符引用也可以参数化。例如：
等价于说：
并且：
等价于：
非终结符引用可以同时具有参数列表和 "opt" 后缀。例如：
是以下的缩写：
在右侧非终结符引用中，使用 "?" 作为参数名称的前缀 使该参数值依赖于当前产生式左侧符号引用中该参数名称的出现。例如：
是以下的缩写：
如果右侧选择以 "[+parameter]" 为前缀，那么该选择只有在引用产生式的非终结符号时使用了命名参数才可用。 如果右侧选择以 "[~parameter]" 为前缀，那么该选择只有在引用产生式的非终结符号时 没有 使用命名参数才可用。这意味着：
是以下的缩写：
并且：
是以下的缩写：
5.1.5.5 one of
当单词 "one of" 跟在文法定义中的冒号后面时，它们表示后续行中的每个终结符号 都是一个可选定义。例如，ECMAScript 的词法文法包含产生式：
这只是以下的便利缩写：
5.1.5.6 [empty]
如果短语 "[empty]" 作为产生式的右侧出现，它表示产生式的右侧不包含终结符或非终结符。
5.1.5.7 前瞻限制
如果短语 "[lookahead = seq]" 出现在产生式的右侧，
它表示只有当标记序列 seq 是紧随其后的输入标记序列的前缀时，才能使用该产生式。类似地，"[lookahead ∈
set]"（其中 set 是标记序列的
这些条件可以被否定。"[lookahead ≠ seq]" 表示只有当 seq 不是紧随其后的输入标记序列的前缀时，才能使用包含的产生式，而 "[lookahead ∉ set]" 表示只有当 set 中没有元素是紧随其后的标记序列的前缀时，才能使用该产生式。
作为示例，给定定义：
定义：
匹配字母 n 后跟一个或多个十进制数字（其中第一个数字是偶数），或者一个十进制数字后面不跟另一个十进制数字。
注意，当这些短语在语法文法中使用时，可能无法明确地识别紧随其后的标记序列，因为确定后续标记需要知道在后续位置使用哪个词法
5.1.5.8 [no LineTerminator here]
如果短语 "[no
表示如果在脚本的 throw 标记和
除非受限产生式禁止出现
5.1.5.9 but not
产生式的右侧可以通过使用短语 "but not" 然后指出要排除的展开来指定某些展开是不被允许的。例如，产生式：
意味着非终结符
5.1.5.10 描述性短语
最后，少数非终结符通过无衬线字体的描述性短语来描述，这是在列出所有选择不切实际的情况下：
5.2 算法约定
本规范通常使用编号列表来指定算法中的步骤。这些算法用于精确指定 ECMAScript 语言构造所需的语义。这些算法并非旨在暗示使用任何特定的实现技术。实际上，可能存在更有效的算法来实现给定的特性。
算法可以使用有序的、逗号分隔的别名序列进行显式参数化，这些别名可以在算法步骤中用于引用在该位置传入的参数。可选参数用方括号（[ , name
]）表示，在算法步骤中与必需参数没有区别。剩余参数可以出现在参数列表的末尾，用前导省略号（, ...name）表示。剩余参数将捕获在必需参数和可选参数之后提供的所有参数到一个
算法步骤可以细分为顺序的子步骤。子步骤是缩进的，并且它们本身可以进一步划分为缩进的子步骤。使用大纲编号约定来标识子步骤，第一级子步骤用小写字母标记，第二级子步骤用小写罗马数字标记。如果需要三个以上的级别，则这些规则会重复，第四级使用数字标签。例如：
- 顶层步骤
- 子步骤。
- 子步骤。
- 子子步骤。
- 子子子步骤
- 子子子子步骤
- 子子子子子步骤
- 子子子子步骤
- 子子子步骤
- 子子步骤。
一个步骤或子步骤可以写成一个“if”谓词，该谓词对其子步骤进行条件限制。在这种情况下，仅当谓词为真时才应用子步骤。如果一个步骤或子步骤以单词“else”开头，则它是一个谓词，该谓词是同一级别上在前的“if”谓词步骤的否定。
一个步骤可以指定其子步骤的迭代应用。
以“断言：”开头的步骤断言其算法的不变条件。此类断言用于明确算法中否则将是隐式的不变量。此类断言不增加额外的语义要求，因此实现无需检查。它们仅用于阐明算法。
算法步骤可以使用“令 x 为 someValue”的形式为任何值声明命名别名。这些别名是引用式的，即 x 和 someValue 都引用相同的基础数据，对其中任何一个的修改对两者都可见。希望避免这种引用式行为的算法步骤应显式复制右侧的值：“令 x 为 someValue 的副本”会创建 someValue 的浅拷贝。
一旦声明，别名就可以在任何后续步骤中引用，并且不得在别名声明之前的步骤中引用。可以使用“将 x 设置为 someOtherValue”的形式修改别名。
5.2.1 抽象操作
为了便于在规范的多个部分中使用，一些算法（称为抽象操作）被命名并以参数化函数形式编写，以便可以从其他算法中按名称引用它们。抽象操作通常使用函数应用样式（如 OperationName(arg1, arg2)）进行引用。一些抽象操作被视为类规范抽象的多态分派方法。此类方法式抽象操作通常使用方法应用样式（如 someValue.OperationName(arg1, arg2)）进行引用。
5.2.2 语法导向操作
语法导向操作是一种命名操作，其定义由算法组成，每个算法都与 ECMAScript
语法中的一个或多个产生式相关联。具有多个备选定义的产生式通常会为每个备选方案提供一个不同的算法。当算法与语法产生式相关联时，它可以像引用算法参数一样引用产生式备选方案的终结符和非终结符。以这种方式使用时，非终结符指的是解析源文本时匹配的实际备选定义。语法产生式或由其派生的
当算法与产生式备选方案相关联时，该备选方案通常不带任何“[ ]”语法注释。此类注释仅影响备选方案的语法识别，对备选方案的相关语义没有影响。
语法导向操作通过使用以下算法中的步骤
- 令 status 为
SomeNonTerminal 的 SyntaxDirectedOperation。 - 令 someParseNode 为某个源文本的解析结果。
- 执行 someParseNode 的 SyntaxDirectedOperation。
- 执行 someParseNode 的
SyntaxDirectedOperation，参数为
"value" 。
除非另有明确规定，否则所有
但是
运行时语义：
5.2.3 运行时语义
指定必须在运行时调用的语义的算法称为运行时语义。运行时语义由
5.2.3.1 Completion ( completionRecord )
抽象操作 Completion 接受参数 completionRecord（一个
5.2.3.2 抛出异常
算法步骤中说要抛出异常，例如：
- 抛出一个
TypeError 异常。
与以下含义相同：
- 返回
ThrowCompletion (一个新创建的TypeError 对象)。
5.2.3.3 ReturnIfAbrupt
算法步骤中说或等效于：
ReturnIfAbrupt (argument)。
与以下含义相同：
断言 ：argument 是一个完成记录 。- 如果 argument 是一个
突然完成 ，则返回Completion (argument)。 - 否则，将 argument 设置为 argument.[[Value]]。
算法步骤中说或等效于：
ReturnIfAbrupt (AbstractOperation())。
与以下含义相同：
- 令 hygienicTemp 为 AbstractOperation()。
断言 ：hygienicTemp 是一个完成记录 。- 如果 hygienicTemp 是一个
突然完成 ，则返回Completion (hygienicTemp)。 - 否则，将 hygienicTemp 设置为 hygienicTemp.[[Value]]。
其中 hygienicTemp 是临时的，并且仅在与 ReturnIfAbrupt 相关的步骤中可见。
算法步骤中说或等效于：
- 令 result 为 AbstractOperation(
ReturnIfAbrupt (argument))。
与以下含义相同：
断言 ：argument 是一个完成记录 。- 如果 argument 是一个
突然完成 ，则返回Completion (argument)。 - 否则，将 argument 设置为 argument.[[Value]]。
- 令 result 为 AbstractOperation(argument)。
5.2.3.4 ReturnIfAbrupt 简写
以 ? 为前缀的
- ? OperationName()。
等效于以下步骤：
ReturnIfAbrupt (OperationName())。
类似地，对于方法应用样式，步骤：
- ? someValue.OperationName()。
等效于：
ReturnIfAbrupt (someValue.OperationName())。
类似地，前缀 ! 用于指示以下抽象操作或
- 令 val 为 ! OperationName()。
等效于以下步骤：
! 或
? 来使用此简写：
- 执行 !
NonTerminal 的 SyntaxDirectedOperation。
5.2.3.5 隐式正常完成
在声明返回
- 当直接返回应用
Completion 、NormalCompletion 、ThrowCompletion 或ReturnCompletion 的结果时 - 当直接返回构造
完成记录 的结果时
如果通过任何其他方式从此类抽象操作返回
- 返回
true 。
与以下任何一种含义相同：
- 返回
NormalCompletion (true )。
或
- 令 completion 为
NormalCompletion (true )。 - 返回
Completion (completion)。
或
- 返回
完成记录 { [[Type]]:normal , [[Value]]:true , [[Target]]:empty }。
请注意，通过
- 返回 ? completion。
以下示例将是编辑错误，因为正在返回一个
- 令 completion 为
NormalCompletion (true )。 - 返回 completion。
5.2.4 静态语义
上下文无关文法不足以表达所有规则，这些规则定义输入元素流是否形成一个有效的、可以求值的 ECMAScript
静态语义规则具有名称，并且通常使用算法定义。命名的静态语义规则与语法产生式相关联，具有多个备选定义的产生式通常会为每个备选方案的每个适用的命名静态语义规则提供一个不同的算法。
一种特殊的静态语义规则是早期错误规则。
5.2.5 数学运算
本规范引用以下类型的数值：
- 数学值：任意实数，用作默认数值类型。
- 扩展数学值：
数学值 以及 +∞ 和 -∞。 - 数字：
IEEE 754-2019 binary64（双精度浮点）值。 - BigInts：
ECMAScript 语言值 ，以一一对应的方式表示任意整数 。
在本规范的语言中，使用下标后缀来区分不同数值种类的数值。下标 𝔽 指的是数字，下标 ℤ 指的是
BigInts。没有下标后缀的数值指的是
通常，当本规范引用一个数值时，例如在短语“y 的长度”或“由四个十六进制数字表示的
当本规范中使用术语整数时，它指的是一个
诸如 +、×、= 和 ≥ 之类的数值运算符指的是由操作数类型决定的那些运算。当应用于
数学函数
数学函数
符号“
短语“将 x 限制在 lower 和 upper
之间”的结果（其中 x 是一个
数学函数
数学函数
数学函数
从下界 a 到上界 b 的区间是一个可能是无限的、可能是空的、相同数值类型的数值集合。每个界限将被描述为包含的或排除的，但不能两者都是。有四种区间，如下所示：
- 从 a（包含）到 b（包含）的
区间 ，也称为从 a 到 b 的闭区间，包括所有相同数值类型的数值 x，使得 a ≤ x ≤ b，且不包括其他值。 - 从 a（包含）到 b（排除）的
区间 包括所有相同数值类型的数值 x，使得 a ≤ x < b，且不包括其他值。 - 从 a（排除）到 b（包含）的
区间 包括所有相同数值类型的数值 x，使得 a < x ≤ b，且不包括其他值。 - 从 a（排除）到 b（排除）的
区间 包括所有相同数值类型的数值 x，使得 a < x < b，且不包括其他值。
例如，从 1（包含）到 2（排除）的
5.2.6 值表示法
在本规范中，Function.prototype.apply 或
let n = 42;）相区别。
5.2.7 同一性
在本规范中，规范值和
从本规范的角度来看，“是”用于比较两个值的相等性，如“如果 bool 是
从 ECMAScript 语言的角度来看，语言值使用
对于规范值，无规范同一性的值的示例包括但不限于：
对于所有
6 ECMAScript 数据类型和值
本规范中的算法操作的值都具有关联的类型。可能的值类型正是本条款中定义的那些类型。类型进一步分为
6.1 ECMAScript 语言类型
ECMAScript 语言类型对应于 ECMAScript 程序员使用 ECMAScript 语言直接操作的值。ECMAScript 语言类型包括 Undefined、Null、Boolean、String、Symbol、Number、BigInt 和 Object。 ECMAScript 语言值 是由 ECMAScript 语言类型表征的值。
6.1.1 Undefined 类型
Undefined 类型只有一个值，称为
6.1.2 Null 类型
Null 类型只有一个值，称为
6.1.3 Boolean 类型
Boolean 类型表示一个逻辑实体，具有两个值，称为
6.1.4 字符串类型
字符串类型是所有长度不超过 253 - 1 个元素的零个或多个 16
位无符号
不解释字符串内容的 ECMAScript 操作不应用任何进一步的语义。解释字符串值的操作将每个元素视为单个 UTF-16 代码单元。但是，ECMAScript
不限制这些代码单元的值或它们之间的关系，因此将字符串内容进一步解释为以 UTF-16 编码的 Unicode 码点序列的操作必须考虑到格式错误的子序列。此类操作对数值在
-
一个既不是
前导代理项 也不是后尾代理项 的代码单元被解释为具有相同值的码点。 -
一个由两个代码单元组成的序列，其中第一个代码单元 c1 是一个
前导代理项 ，第二个代码单元 c2 是一个后尾代理项 ，则该序列是一个代理对，并被解释为具有值 (c1 - 0xD800) × 0x400 + (c2 - 0xDC00) + 0x10000 的码点。（参见11.1.3 ） -
一个
前导代理项 或后尾代理项 ，但不是代理对 的一部分，则被解释为具有相同值的码点。
函数 String.prototype.normalize（参见 String.prototype.localeCompare（参见
这种设计背后的基本原理是使字符串的实现尽可能简单和高性能。如果
在本规范中，短语“A、B、... 的字符串连接”（其中每个参数都是字符串值、代码单元或代码单元序列）表示其代码单元序列是每个参数（按顺序）的代码单元（按顺序）连接而成的字符串值。
短语“S 从 inclusiveStart 到 exclusiveEnd 的子字符串”（其中 S 是字符串值或代码单元序列，inclusiveStart 和
exclusiveEnd 是
短语“ASCII 词字符”表示以下字符串值，该值仅由 Unicode
基本拉丁块中的所有字母和数字以及 U+005F (LOW LINE) 组成：
由于历史原因，它对各种算法具有重要意义。
6.1.4.1 StringIndexOf ( string, searchValue, fromIndex )
抽象操作 StringIndexOf 接受参数 string (一个字符串)、searchValue (一个字符串) 和
fromIndex (一个非负
如果 searchValue 是空字符串且 fromIndex ≤ string 的长度，则此算法返回 fromIndex。空字符串实际上在字符串中的每个位置都能找到，包括最后一个代码单元之后。
如果 fromIndex + searchValue 的长度 > string 的长度，则此算法始终返回
6.1.4.2 StringLastIndexOf ( string, searchValue, fromIndex )
抽象操作 StringLastIndexOf 接受参数 string (一个字符串)、searchValue (一个字符串) 和
fromIndex (一个非负
如果 searchValue 是空字符串，则此算法返回 fromIndex。空字符串实际上在字符串中的每个位置都能找到，包括最后一个代码单元之后。
6.1.5 Symbol 类型
Symbol 类型是所有可用作对象属性键（
每个可能的 Symbol 值都是唯一且不可变的。
每个 Symbol 值都不可变地持有一个关联值，称为 [[Description]]，该值要么是
6.1.5.1 知名符号
知名符号是本规范算法明确引用的内置 Symbol 值。它们通常用作属性的键，这些属性的值充当规范算法的扩展点。除非另有规定，否则知名符号值由所有
在本规范中，使用标准的
%Symbol.name%。特别是，使用了以下名称：@@asyncIterator、@@hasInstance、@@isConcatSpreadable、@@| 规范名称 | [[Description]] | 值和用途 |
|---|---|---|
| %Symbol.asyncIterator% |
|
一个返回对象默认for-await-of 语句的语义调用。
|
| %Symbol.hasInstance% |
|
一个确定instanceof 运算符的语义调用。
|
| %Symbol.isConcatSpreadable% |
|
一个布尔值属性，如果为 true，则表示一个对象应由 Array.prototype.concat |
| %Symbol.iterator% |
|
一个返回对象默认 |
| %Symbol.match% |
|
一个正则表达式方法，用于将正则表达式与字符串进行匹配。由 String.prototype.match |
| %Symbol.matchAll% |
|
一个正则表达式方法，返回一个String.prototype.matchAll |
| %Symbol.replace% |
|
一个正则表达式方法，用于替换字符串中匹配的子字符串。由 String.prototype.replace |
| %Symbol.search% |
|
一个正则表达式方法，返回字符串中与正则表达式匹配的索引。由 String.prototype.search |
| %Symbol.species% |
|
一个函数值属性，是用于创建派生对象的 |
| %Symbol.split% |
|
一个正则表达式方法，用于在与正则表达式匹配的索引处拆分字符串。由 String.prototype.split |
| %Symbol.toPrimitive% |
|
一个将对象转换为相应原始值的方法。由 |
| %Symbol.toStringTag% |
|
一个字符串值属性，用于创建对象的默认字符串描述。由内置方法 Object.prototype.toString |
| %Symbol.unscopables% |
|
一个对象值属性，其自身和继承的属性名称是从关联对象的 with 环境绑定中排除的属性名称。
|
6.1.6 数字类型
ECMAScript 有两种内置的数字类型：Number 和 BigInt。以下
由于数字类型通常无法在不损失精度或截断的情况下进行转换，因此 ECMAScript 语言不提供这些类型之间的隐式转换。在调用需要另一种类型的函数时，程序员必须显式调用
Number 和 BigInt 函数在类型之间进行转换。
ECMAScript 的第一版及后续版本为某些运算符提供了可能损失精度或
6.1.6.1 Number 类型
Number 类型恰好有
18,437,736,874,454,810,627 (即 NaN 产生。）在某些实现中，外部代码可能能够检测到各种 NaN
值之间的差异，但这种行为是
还有另外两个特殊值，称为+Infinity (或简称 Infinity) 和 -Infinity 产生。）
其余 18,437,736,874,454,810,624 (即
注意，既有+0 (或简称 0) 和 -0 产生。）
18,437,736,874,454,810,622 (即
其中 18,428,729,675,200,069,632 (即
其中 s 是 1 或 -1，m 是
其余 9,007,199,254,740,990 (即
其中 s 是 1 或 -1，m 是
注意，所有大小不超过 253 的正负
如果一个
在本规范中，短语“x 的Number 值”（其中 x 表示一个精确的实数数学量，甚至可能是一个无理数，如
π）指的是按以下方式选择的 Number 值。考虑 Number 类型的所有
+∞ 的
某些 ECMAScript 运算符仅处理特定范围内的
6.1.6.1.1 Number::unaryMinus ( x )
抽象操作 Number::unaryMinus 接受参数 x (一个 Number) 并返回一个 Number。调用时它执行以下步骤：
- 如果 x 是
NaN ，则返回NaN 。 - 返回 x 的负值；即，计算一个具有相同大小但符号相反的 Number。
6.1.6.1.2 Number::bitwiseNOT ( x )
抽象操作 Number::bitwiseNOT 接受参数 x (一个 Number) 并返回一个
6.1.6.1.3 Number::exponentiate ( base, exponent )
抽象操作 Number::exponentiate 接受参数 base (一个 Number) 和 exponent (一个
Number) 并返回一个 Number。它返回一个
- 如果 exponent 是
NaN ，则返回NaN 。 - 如果 exponent 是
+0 𝔽 或-0 𝔽，则返回1 𝔽。 - 如果 base 是
NaN ，则返回NaN 。 - 如果 base 是
+∞ 𝔽，则- 如果 exponent >
+0 𝔽，则返回+∞ 𝔽。否则，返回+0 𝔽。
- 如果 exponent >
- 如果 base 是
-∞ 𝔽，则 - 如果 base 是
+0 𝔽，则- 如果 exponent >
+0 𝔽，则返回+0 𝔽。否则，返回+∞ 𝔽。
- 如果 exponent >
- 如果 base 是
-0 𝔽，则 断言 ：base 是有限的 ，并且既不是+0 𝔽 也不是-0 𝔽。- 如果 exponent 是
+∞ 𝔽，则 - 如果 exponent 是
-∞ 𝔽，则 断言 ：exponent 是有限的 ，并且既不是+0 𝔽 也不是-0 𝔽。- 如果 base <
-0 𝔽 且 exponent 不是一个整数 Number ，则返回NaN 。 - 返回一个
实现近似 的 Number 值，表示ℝ (base) 的ℝ (exponent) 次幂的结果。
当 base 是 ** exponent
的结果与
6.1.6.1.4 Number::multiply ( x, y )
抽象操作 Number::multiply 接受参数 x (一个 Number) 和 y (一个 Number) 并返回一个
Number。它根据
6.1.6.1.5 Number::divide ( x, y )
抽象操作 Number::divide 接受参数 x (一个 Number) 和 y (一个 Number) 并返回一个
Number。它根据
- 如果 x 是
NaN 或 y 是NaN ，则返回NaN 。 - 如果 x 是
+∞ 𝔽 或-∞ 𝔽，则- 如果 y 是
+∞ 𝔽 或-∞ 𝔽，则返回NaN 。 - 如果 y 是
+0 𝔽 或 y >+0 𝔽，则返回 x。 - 返回 -x。
- 如果 y 是
- 如果 y 是
+∞ 𝔽，则- 如果 x 是
+0 𝔽 或 x >+0 𝔽，则返回+0 𝔽。否则，返回-0 𝔽。
- 如果 x 是
- 如果 y 是
-∞ 𝔽，则- 如果 x 是
+0 𝔽 或 x >+0 𝔽，则返回-0 𝔽。否则，返回+0 𝔽。
- 如果 x 是
- 如果 x 是
+0 𝔽 或-0 𝔽，则- 如果 y 是
+0 𝔽 或-0 𝔽，则返回NaN 。 - 如果 y >
+0 𝔽，则返回 x。 - 返回 -x。
- 如果 y 是
- 如果 y 是
+0 𝔽，则- 如果 x >
+0 𝔽，则返回+∞ 𝔽。否则，返回-∞ 𝔽。
- 如果 x >
- 如果 y 是
-0 𝔽，则- 如果 x >
+0 𝔽，则返回-∞ 𝔽。否则，返回+∞ 𝔽。
- 如果 x >
- 返回
𝔽 (ℝ (x) /ℝ (y))。
6.1.6.1.6 Number::remainder ( n, d )
抽象操作 Number::remainder 接受参数 n (一个 Number) 和 d (一个 Number) 并返回一个 Number。它产生其操作数隐式除法的余数，其中 n 是被除数，d 是除数。调用时它执行以下步骤：
在 C 和 C++ 中，余数运算符仅接受整数操作数；在 ECMAScript 中，它也接受浮点操作数。
% 运算符计算的浮点余数运算的结果与 % 在浮点运算上的行为类似于 Java 6.1.6.1.7 Number::add ( x, y )
抽象操作 Number::add 接受参数 x (一个 Number) 和 y (一个 Number) 并返回一个
Number。它根据
6.1.6.1.8 Number::subtract ( x, y )
抽象操作 Number::subtract 接受参数 x (一个 Number) 和 y (一个 Number) 并返回一个 Number。它执行减法，产生其操作数的差；x 是被减数，y 是减数。调用时它执行以下步骤：
- 返回
Number::add (x,Number::unaryMinus (y))。
x - y 总是产生与 x + (-y) 相同的结果。
6.1.6.1.9 Number::leftShift ( x, y )
抽象操作 Number::leftShift 接受参数 x (一个 Number) 和 y (一个 Number)
并返回一个
6.1.6.1.10 Number::signedRightShift ( x, y )
抽象操作 Number::signedRightShift 接受参数 x (一个 Number) 和 y (一个 Number)
并返回一个
6.1.6.1.11 Number::unsignedRightShift ( x, y )
抽象操作 Number::unsignedRightShift 接受参数 x (一个 Number) 和 y (一个 Number)
并返回一个
6.1.6.1.12 Number::lessThan ( x, y )
抽象操作 Number::lessThan 接受参数 x (一个 Number) 和 y (一个 Number) 并返回一个
Boolean 或
6.1.6.1.13 Number::equal ( x, y )
抽象操作 Number::equal 接受参数 x (一个 Number) 和 y (一个 Number) 并返回一个 Boolean。调用时它执行以下步骤：
- 如果 x 是
NaN ，则返回false 。 - 如果 y 是
NaN ，则返回false 。 - 如果 x 是 y，则返回
true 。 - 如果 x 是
+0 𝔽 且 y 是-0 𝔽，则返回true 。 - 如果 x 是
-0 𝔽 且 y 是+0 𝔽，则返回true 。 - 返回
false 。
6.1.6.1.14 Number::sameValue ( x, y )
抽象操作 Number::sameValue 接受参数 x (一个 Number) 和 y (一个 Number) 并返回一个 Boolean。调用时它执行以下步骤：
- 如果 x 是
NaN 且 y 是NaN ，则返回true 。 - 如果 x 是
+0 𝔽 且 y 是-0 𝔽，则返回false 。 - 如果 x 是
-0 𝔽 且 y 是+0 𝔽，则返回false 。 - 如果 x 是 y，则返回
true 。 - 返回
false 。
6.1.6.1.15 Number::sameValueZero ( x, y )
抽象操作 Number::sameValueZero 接受参数 x (一个 Number) 和 y (一个 Number) 并返回一个 Boolean。调用时它执行以下步骤：
- 如果 x 是
NaN 且 y 是NaN ，则返回true 。 - 如果 x 是
+0 𝔽 且 y 是-0 𝔽，则返回true 。 - 如果 x 是
-0 𝔽 且 y 是+0 𝔽，则返回true 。 - 如果 x 是 y，则返回
true 。 - 返回
false 。
6.1.6.1.16 NumberBitwiseOp ( op, x, y )
抽象操作 NumberBitwiseOp 接受参数 op (&、^ 或
|)、x (一个 Number) 和 y (一个 Number) 并返回一个
- 令 lNum 为 !
ToInt32 (x)。 - 令 rNum 为 !
ToInt32 (y)。 - 令 lBits 为表示
ℝ (lNum) 的 32 位二进制补码位串。 - 令 rBits 为表示
ℝ (rNum) 的 32 位二进制补码位串。 - 如果 op 是
&，则- 令 result 为对 lBits 和 rBits 应用按位与运算的结果。
- 否则，如果 op 是
^，则- 令 result 为对 lBits 和 rBits 应用按位异或 (XOR) 运算的结果。
- 否则，
断言 ：op 是|。- 令 result 为对 lBits 和 rBits 应用按位或运算的结果。
- 返回由 32 位二进制补码位串 result 表示的
整数 的Number 值 。
6.1.6.1.17 Number::bitwiseAND ( x, y )
抽象操作 Number::bitwiseAND 接受参数 x (一个 Number) 和 y (一个 Number)
并返回一个
- 返回
NumberBitwiseOp (&, x, y)。
6.1.6.1.18 Number::bitwiseXOR ( x, y )
抽象操作 Number::bitwiseXOR 接受参数 x (一个 Number) 和 y (一个 Number)
并返回一个
- 返回
NumberBitwiseOp (^, x, y)。
6.1.6.1.19 Number::bitwiseOR ( x, y )
抽象操作 Number::bitwiseOR 接受参数 x (一个 Number) 和 y (一个 Number)
并返回一个
- 返回
NumberBitwiseOp (|, x, y)。
6.1.6.1.20 Number::toString ( x, radix )
抽象操作 Number::toString 接受参数 x (一个 Number) 和 radix (一个
- 如果 x 是
NaN ，则返回"NaN" 。 - 如果 x 是
+0 𝔽 或-0 𝔽，则返回"0" 。 - 如果 x <
-0 𝔽，则返回字符串连接 "-" 和Number::toString (-x, radix)。 - 如果 x 是
+∞ 𝔽，则返回"Infinity" 。 - 令 n、k 和
s 为
整数 ，使得 k ≥ 1，radixk - 1 ≤ s < radixk，𝔽 (s × radixn - k) 是 x，并且 k 尽可能小。注意，k 是使用基数 radix 表示 s 的位数，s 不能被 radix 整除，并且 s 的最低有效位不一定由这些标准唯一确定。 - 如果 radix ≠ 10 或 n 在
闭区间 [-5, 21] 内，则 - 注意：在这种情况下，输入将使用科学 E 表示法表示，例如
1.2e+3。 断言 ：radix 是 10。- 如果 n < 0，则
- 令 exponentSign 为代码单元 0x002D (HYPHEN-MINUS)。
- 否则，
- 令 exponentSign 为代码单元 0x002B (PLUS SIGN)。
- 如果 k = 1，则
- 返回以下各项的
字符串连接 ：- s 的十进制表示的最高有效数字的代码单元
- 代码单元 0x002E (FULL STOP)
- s 的十进制表示的其余 k - 1 位数字的代码单元
- 代码单元 0x0065 (LATIN SMALL LETTER E)
- exponentSign
abs (n - 1) 的十进制表示的代码单元
ECMAScript 的实现者可能会发现 David M. Gay 编写的用于浮点数二进制到十进制转换的论文和代码很有用：
Gay, David M. Correctly Rounded Binary-Decimal and Decimal-Binary Conversions.
Numerical Analysis, Manuscript 90-10. AT&T Bell Laboratories (Murray Hill,
New Jersey). 1990年11月30日。可从以下网址获取：
https://ampl.com/_archive/first-website/REFS/rounding.pdf。
相关代码可从以下网址获取：
http://netlib.sandia.gov/fp/dtoa.c
和
http://netlib.sandia.gov/fp/g_fmt.c
也可以在各种 netlib 镜像站点找到。
6.1.6.2 BigInt 类型
BigInt 类型表示一个
6.1.6.2.1 BigInt::unaryMinus ( x )
抽象操作 BigInt::unaryMinus 接受参数 x（一个 BigInt）并返回一个 BigInt。调用时执行以下步骤：
- 如果 x =
0 ℤ，返回0 ℤ。 - 返回 -x。
6.1.6.2.2 BigInt::bitwiseNOT ( x )
抽象操作 BigInt::bitwiseNOT 接受参数 x（一个 BigInt）并返回一个 BigInt。它返回 x 的一的补码。调用时执行以下步骤：
- 返回 -x -
1 ℤ。
6.1.6.2.3 BigInt::exponentiate ( base, exponent )
抽象操作 BigInt::exponentiate 接受参数 base（一个 BigInt）和 exponent（一个
BigInt），返回
- 如果 exponent <
0 ℤ，抛出RangeError 异常。 - 如果 base =
0 ℤ 且 exponent =0 ℤ，返回1 ℤ。 - 返回 base 的 exponent 次幂。
6.1.6.2.4 BigInt::multiply ( x, y )
抽象操作 BigInt::multiply 接受参数 x（一个 BigInt）和 y（一个 BigInt）并返回一个 BigInt。调用时执行以下步骤：
- 返回 x × y。
6.1.6.2.5 BigInt::divide ( x, y )
抽象操作 BigInt::divide 接受参数 x（一个 BigInt）和 y（一个 BigInt），返回
6.1.6.2.6 BigInt::remainder ( n, d )
抽象操作 BigInt::remainder 接受参数 n（一个 BigInt）和 d（一个 BigInt），返回
6.1.6.2.7 BigInt::add ( x, y )
抽象操作 BigInt::add 接受参数 x（一个 BigInt）和 y（一个 BigInt）并返回一个 BigInt。调用时执行以下步骤：
- 返回 x + y。
6.1.6.2.8 BigInt::subtract ( x, y )
抽象操作 BigInt::subtract 接受参数 x（一个 BigInt）和 y（一个 BigInt）并返回一个 BigInt。调用时执行以下步骤：
- 返回 x - y。
6.1.6.2.9 BigInt::leftShift ( x, y )
抽象操作 BigInt::leftShift 接受参数 x（一个 BigInt）和 y（一个 BigInt）并返回一个 BigInt。调用时执行以下步骤：
6.1.6.2.10 BigInt::signedRightShift ( x, y )
抽象操作 BigInt::signedRightShift 接受参数 x（一个 BigInt）和 y（一个 BigInt）并返回一个 BigInt。调用时执行以下步骤：
- 返回
BigInt::leftShift (x, -y)。
6.1.6.2.11 BigInt::unsignedRightShift ( x, y )
抽象操作 BigInt::unsignedRightShift 接受参数 x（一个 BigInt）和 y（一个
BigInt）并返回
- 抛出
TypeError 异常。
6.1.6.2.12 BigInt::lessThan ( x, y )
抽象操作 BigInt::lessThan 接受参数 x（一个 BigInt）和 y（一个 BigInt）并返回一个布尔值。调用时执行以下步骤：
6.1.6.2.13 BigInt::equal ( x, y )
抽象操作 BigInt::equal 接受参数 x（一个 BigInt）和 y（一个 BigInt）并返回一个布尔值。调用时执行以下步骤：
6.1.6.2.14 BinaryAnd ( x, y )
抽象操作 BinaryAnd 接受参数 x（0 或 1）和 y（0 或 1）并返回 0 或 1。调用时执行以下步骤：
- 如果 x = 1 且 y = 1，返回 1。
- 否则，返回 0。
6.1.6.2.15 BinaryOr ( x, y )
抽象操作 BinaryOr 接受参数 x（0 或 1）和 y（0 或 1）并返回 0 或 1。调用时执行以下步骤：
- 如果 x = 1 或 y = 1，返回 1。
- 否则，返回 0。
6.1.6.2.16 BinaryXor ( x, y )
抽象操作 BinaryXor 接受参数 x（0 或 1）和 y（0 或 1）并返回 0 或 1。调用时执行以下步骤：
- 如果 x = 1 且 y = 0，返回 1。
- 否则如果 x = 0 且 y = 1，返回 1。
- 否则，返回 0。
6.1.6.2.17 BigIntBitwiseOp ( op, x, y )
抽象操作 BigIntBitwiseOp 接受参数 op（&、^ 或
|）、x（一个 BigInt）和 y（一个 BigInt）并返回一个 BigInt。调用时执行以下步骤：
- 设置 x 为
ℝ (x)。 - 设置 y 为
ℝ (y)。 - 令 result 为 0。
- 令 shift 为 0。
- 重复执行，直到 (x = 0 或 x = -1) 且 (y = 0 或 y = -1)：
- 如果 op 是
&，则 - 否则如果 op 是
|，则 - 否则，
- 如果 tmp ≠ 0，则
- 设置 result 为 result - 2shift。
- 注意：这扩展了符号。
- 返回 result 的
BigInt 值 。
6.1.6.2.18 BigInt::bitwiseAND ( x, y )
抽象操作 BigInt::bitwiseAND 接受参数 x（一个 BigInt）和 y（一个 BigInt）并返回一个 BigInt。调用时执行以下步骤：
- 返回
BigIntBitwiseOp (&, x, y)。
6.1.6.2.19 BigInt::bitwiseXOR ( x, y )
抽象操作 BigInt::bitwiseXOR 接受参数 x（一个 BigInt）和 y（一个 BigInt）并返回一个 BigInt。调用时执行以下步骤：
- 返回
BigIntBitwiseOp (^, x, y)。
6.1.6.2.20 BigInt::bitwiseOR ( x, y )
抽象操作 BigInt::bitwiseOR 接受参数 x（一个 BigInt）和 y（一个 BigInt）并返回一个 BigInt。调用时执行以下步骤：
- 返回
BigIntBitwiseOp (|, x, y)。
6.1.6.2.21 BigInt::toString ( x, radix )
抽象操作 BigInt::toString 接受参数 x（一个 BigInt）和 radix（一个在 2 到 36
的
- 如果 x <
0 ℤ，返回"-" 和BigInt::toString (-x, radix) 的字符串连接 。 - 返回使用基数 radix 表示 x 的字符串值。
6.1.7 Object 类型
Object 类型的每个实例，也简称为"一个 Object"，表示属性的集合。每个属性要么是数据属性，要么是访问器属性：
-
数据属性将键值与
ECMAScript 语言值 和一组布尔属性关联。 -
访问器属性将键值与一个或两个访问器函数以及一组布尔属性关联。访问器函数用于存储或检索与该属性关联的
ECMAScript 语言值 。
对象的属性使用
整数索引是
所有对象在逻辑上都是属性的集合，但存在多种形式的对象，它们在访问和操作属性的语义上有所不同。请参见
此外，某些对象是可调用的；这些被称为函数或
6.1.7.1 属性特性
本规范使用特性来定义和解释 Object 属性的状态，如
| 特性名称 | 存在该特性的属性类型 | 值域 | 默认值 | 描述 |
|---|---|---|---|---|
| [[Value]] | 通过对属性的 get 访问检索到的值。 | |||
| [[Writable]] | 布尔值 | 如果为 |
||
| [[Get]] | Object 或 |
如果值 |
||
| [[Set]] | Object 或 |
如果值 |
||
| [[Enumerable]] | 布尔值 | 如果为 |
||
| [[Configurable]] | 布尔值 | 如果为 |
6.1.7.2 对象内部方法和内部槽
在 ECMAScript 中，对象的实际语义通过称为内部方法的算法指定。ECMAScript 引擎中的每个对象都与一组定义其运行时行为的内部方法相关联。这些内部方法不是 ECMAScript 语言的一部分。它们由本规范纯粹为了解释目的而定义。但是，ECMAScript 实现中的每个对象都必须按照与其关联的内部方法所指定的方式行为。实现这一点的确切方式由实现决定。
内部方法名称是多态的。这意味着当在不同的对象值上调用相同的内部方法名称时，可能执行不同的算法。实际调用内部方法的对象是调用的"目标"。如果在运行时，算法的实现尝试使用对象不支持的内部方法，则抛出
内部槽对应于与对象关联并由各种 ECMAScript 规范算法使用的内部状态。内部槽不是对象属性，它们不被继承。根据特定的内部槽规范，这种状态可能由任何
所有对象都有一个名为 [[PrivateElements]] 的内部槽，它是
内部方法和内部槽在本规范中使用双方括号 [[ ]] 括起来的名称标识。
普通对象是满足以下所有条件的对象：
- 对于
表 4 中列出的内部方法，对象使用10.1 中定义的那些。 - 如果对象有 [[Call]] 内部方法，它使用
10.2.1 中定义的或10.3.1 中定义的。 - 如果对象有 [[Construct]] 内部方法，它使用
10.2.2 中定义的或10.3.2 中定义的。
异质对象是不是
本规范通过对象的内部方法识别不同种类的
除了参数之外，内部方法始终可以访问作为方法调用目标的对象。
内部方法隐式返回
| 内部方法 | 签名 | 描述 |
|---|---|---|
| [[GetPrototypeOf]] | ( ) → Object | Null | 确定为此对象提供继承属性的对象。 |
| [[SetPrototypeOf]] | (Object | Null) → Boolean | 将此对象与提供继承属性的另一个对象关联。传递 |
| [[IsExtensible]] | ( ) → Boolean | 确定是否允许向此对象添加额外属性。 |
| [[PreventExtensions]] | ( ) → Boolean | 控制是否可以向此对象添加新属性。如果操作成功则返回 |
| [[GetOwnProperty]] | (propertyKey) → Undefined | |
返回此对象键为 propertyKey 的自有属性的 |
| [[DefineOwnProperty]] | (propertyKey, PropertyDescriptor) → Boolean | 创建或更改键为 propertyKey 的自有属性，使其具有 PropertyDescriptor
描述的状态。如果该属性成功创建/更新则返回 |
| [[HasProperty]] | (propertyKey) → Boolean | 返回布尔值，表示此对象是否已经具有键为 propertyKey 的自有或继承属性。 |
| [[Get]] | (propertyKey, Receiver) → any | 从此对象返回键为 propertyKey 的属性值。如果必须执行任何 ECMAScript
代码来检索属性值，Receiver 用作评估代码时的 |
| [[Set]] | (propertyKey, value, Receiver) → Boolean | 将键为 propertyKey 的属性值设置为 value。如果必须执行任何 ECMAScript
代码来设置属性值，Receiver 用作评估代码时的 |
| [[Delete]] | (propertyKey) → Boolean | 从此对象中删除键为 propertyKey 的自有属性。如果属性未被删除且仍然存在则返回
|
| [[OwnPropertyKeys]] | ( ) → |
返回一个 |
| 内部方法 | 签名 | 描述 |
|---|---|---|
| [[Call]] | (any, a |
执行与此对象关联的代码。通过函数调用表达式调用。内部方法的参数是 |
| [[Construct]] | (a |
创建对象。通过 new 操作符或 super
调用调用。内部方法的第一个参数是一个super
调用的参数。第二个参数是最初应用 new 操作符的对象。实现此内部方法的对象称为 |
6.1.7.3 基本内部方法的不变式
ECMAScript 引擎中对象的内部方法必须符合下面指定的不变式列表。本规范中的普通 ECMAScript 对象以及所有标准
任何实现提供的
实现不得允许以任何方式规避这些不变式，例如通过提供实现基本内部方法功能但不强制执行其不变式的替代接口。
定义：
- 内部方法的 目标 是调用内部方法的对象。
-
如果目标被观察到从其 [[IsExtensible]] 内部方法返回
false ，或从其 [[PreventExtensions]] 内部方法返回true ，则目标是 不可扩展的。 - 不存在的 属性是在不可扩展目标上不作为自有属性存在的属性。
-
所有对
SameValue 的引用都根据SameValue 算法的定义。
返回值：
任何内部方法返回的值必须是一个
- [[Type]] =
normal ，[[Target]] =empty ，并且 [[Value]] = 下面为该内部方法显示的"正常返回类型"的值，或 - [[Type]] =
throw ，[[Target]] =empty ，并且 [[Value]] = 任何ECMAScript 语言值 。
内部方法不得返回
[[GetPrototypeOf]] ( )
- 正常返回类型是 Object 或 Null。
-
如果目标是不可扩展的，并且 [[GetPrototypeOf]] 返回值 V，那么将来对 [[GetPrototypeOf]] 的所有调用都应该返回与 V
SameValue 相同的值。
[[SetPrototypeOf]] ( V )
- 正常返回类型是 Boolean。
-
如果目标是不可扩展的，[[SetPrototypeOf]] 必须返回
false ，除非 V 与目标观察到的 [[GetPrototypeOf]] 值为SameValue 。
[[IsExtensible]] ( )
- 正常返回类型是 Boolean。
-
如果 [[IsExtensible]] 返回
false ，将来在目标上的所有 [[IsExtensible]] 调用必须返回false 。
[[PreventExtensions]] ( )
- 正常返回类型是 Boolean。
-
如果 [[PreventExtensions]] 返回
true ，将来在目标上的所有 [[IsExtensible]] 调用必须返回false ，并且目标现在被视为不可扩展的。
[[GetOwnProperty]] ( P )
-
正常返回类型是
属性描述符 或 Undefined。 -
如果返回值是
属性描述符 ，它必须是一个完全填充的属性描述符 。 -
如果 P 被描述为不可配置、不可写的自有
数据属性 ，将来对 [[GetOwnProperty]] ( P ) 的所有调用必须返回其 [[Value]] 与 P 的 [[Value]] 特性为SameValue 的属性描述符 。 -
如果 P 的除 [[Writable]] 和 [[Value]] 之外的特性可能随时间改变，或者属性可能被删除，那么 P 的 [[Configurable]] 特性必须是
true 。 -
如果 [[Writable]] 特性可能从
false 变为true ，那么 [[Configurable]] 特性必须是true 。 -
如果目标是不可扩展的并且 P 是不存在的，那么将来在目标上对 [[GetOwnProperty]]
(P) 的所有调用必须将 P 描述为不存在的（即 [[GetOwnProperty]] (P) 必须返回
undefined ）。
作为第三个不变式的结果，如果属性被描述为
[[DefineOwnProperty]] ( P, Desc )
- 正常返回类型是 Boolean。
-
如果 P 之前被观察为目标的不可配置自有属性，那么 [[DefineOwnProperty]] 必须返回
false ，除非以下之一： -
如果目标是不可扩展的并且 P 是不存在的自有属性，那么 [[DefineOwnProperty]]
(P, Desc) 必须返回
false 。也就是说，不可扩展的目标对象不能用新属性扩展。
[[HasProperty]] ( P )
- 正常返回类型是 Boolean。
-
如果 P 之前被观察为目标的不可配置自有数据或
访问器属性 ，那么 [[HasProperty]] 必须返回true 。
[[Get]] ( P, Receiver )
-
正常返回类型是任何
ECMAScript 语言类型 。 -
如果 P 之前被观察为目标的值为 V 的不可配置、不可写的自有
数据属性 ，那么 [[Get]] 必须返回与 VSameValue 相同的值。 -
如果 P 之前被观察为目标的 [[Get]] 特性为
undefined 的不可配置自有访问器属性 ，那么 [[Get]] 操作必须返回undefined 。
[[Set]] ( P, V, Receiver )
- 正常返回类型是 Boolean。
-
如果 P 之前被观察为目标的不可配置、不可写的自有
数据属性 ，那么 [[Set]] 必须返回false ，除非 V 与 P 的 [[Value]] 特性为SameValue 。 -
如果 P 之前被观察为目标的 [[Set]] 特性为
undefined 的不可配置自有访问器属性 ，那么 [[Set]] 操作必须返回false 。
[[Delete]] ( P )
- 正常返回类型是 Boolean。
-
如果 P 之前被观察为目标的不可配置自有数据或
访问器属性 ，那么 [[Delete]] 必须返回false 。
[[OwnPropertyKeys]] ( )
-
正常返回类型是
列表 。 -
返回的
列表 不得包含任何重复条目。 -
返回的
列表 的每个元素必须是属性键 。 -
返回的
列表 必须至少包含所有之前被观察到的不可配置自有属性的键。 -
如果目标是不可扩展的，返回的
列表 必须只包含使用 [[GetOwnProperty]] 可观察到的目标的所有自有属性的键。
[[Call]] ( )
-
正常返回类型是任何
ECMAScript 语言类型 。
[[Construct]] ( )
- 正常返回类型是 Object。
- 目标也必须有一个 [[Call]] 内部方法。
6.1.7.4 知名内置对象
知名内置对象是被本规范算法明确引用的内置对象，通常具有
在本规范中，像 %name% 这样的引用意味着与当前
6.2 ECMAScript 规范类型
规范类型对应于在算法中用于描述 ECMAScript 语言构造和
6.2.1 枚举规范类型
枚举是规范内部的值，不能从 ECMAScript
代码直接观察到。枚举使用
6.2.2 列表和记录规范类型
列表类型用于解释 new
表达式、函数调用和其他需要简单有序值列表的算法中参数列表的求值（参见
当算法遍历列表的元素而不指定顺序时，使用的顺序是列表中元素的顺序。
为了在本规范中方便表示，可以使用字面量语法来表达新的列表值。例如，« 1, 2 » 定义了一个有两个元素的列表值，每个元素都初始化为特定值。新的空列表可以表示为 « »。
在本规范中，短语"A、B、... 的列表连接"（其中每个参数都是可能为空的列表）表示一个新的列表值，其元素是每个参数的元素（按顺序）的连接（按顺序）。
当应用于字符串列表时，短语"按字典序码元顺序排序"意味着按每个码元的数值排序，直到较短字符串的长度，如果所有都相等，则较短的字符串排在较长的字符串之前，如抽象操作
记录类型用于描述本规范算法中的数据聚合。记录类型值由一个或多个命名字段组成。每个字段的值是
为了在本规范中方便表示，可以使用类似对象字面量的语法来表达记录值。例如，{ [[Field1]]: 42, [[Field2]]:
在规范文本和算法中，可以使用点记法来引用记录值的特定字段。例如，如果 R 是前一段中显示的记录，那么 R.[[Field2]] 是"R 中名为 [[Field2]] 的字段"的简写。
常用记录字段组合的模式可以被命名，该名称可以用作字面量记录值的前缀，以标识所描述的特定类型的聚合。例如：PropertyDescriptor { [[Value]]: 42, [[Writable]]:
6.2.3 集合和关系规范类型
集合类型用于解释在
关系类型用于解释对集合的约束。关系类型的值是其值域中值的有序对的集合。例如，事件上的关系是事件有序对的集合。对于关系 R 和 R 值域中的两个值 a 和 b，a R b 是说有序对 (a, b) 是 R 的成员的简写。关系是相对于某些条件的最小关系，当它是满足这些条件的最小关系时。
严格偏序是满足以下条件的关系值 R。
-
对于 R 域中的所有 a、b 和 c：
- a R a 不成立，并且
- 如果 a R b 且 b R c，那么 a R c。
上述两个性质分别称为非反射性和传递性。
严格全序是满足以下条件的关系值 R。
-
对于 R 域中的所有 a、b 和 c：
- a 是 b 或 a R b 或 b R a，并且
- a R a 不成立，并且
- 如果 a R b 且 b R c，那么 a R c。
上述三个性质分别称为完全性、非反射性和传递性。
6.2.4 完成记录规范类型
完成记录规范类型用于解释值和控制流的运行时传播，例如执行非本地控制转移的语句（break、continue、return
和 throw）的行为。
完成记录具有
以下简写术语有时用于指代完成记录。
- 正常完成指任何 [[Type]] 值为
normal 的完成记录。 - break 完成指任何 [[Type]] 值为
break 的完成记录。 - continue 完成指任何 [[Type]] 值为
continue 的完成记录。 - return 完成指任何 [[Type]] 值为
return 的完成记录。 - throw 完成指任何 [[Type]] 值为
throw 的完成记录。 - 突然完成指任何 [[Type]] 值不是
normal 的完成记录。 - 包含某种类型值的正常完成指在其 [[Value]] 字段中具有该类型值的正常完成。
本规范中定义的可调用对象只返回正常完成或 throw 完成。返回任何其他类型的完成记录被认为是编辑错误。
6.2.4.1 NormalCompletion ( value )
抽象操作 NormalCompletion 接受参数 value（除
- 返回
完成记录 { [[Type]]:normal , [[Value]]: value, [[Target]]:empty }。
6.2.4.2 ThrowCompletion ( value )
抽象操作 ThrowCompletion 接受参数 value（一个
- 返回
完成记录 { [[Type]]:throw , [[Value]]: value, [[Target]]:empty }。
6.2.4.3 ReturnCompletion ( value )
抽象操作 ReturnCompletion 接受参数 value（一个
- 返回
完成记录 { [[Type]]:return , [[Value]]: value, [[Target]]:empty }。
6.2.4.4 UpdateEmpty ( completionRecord, value )
抽象操作 UpdateEmpty 接受参数 completionRecord（一个
6.2.5 引用记录规范类型
引用记录类型用于解释诸如
delete、typeof、赋值运算符、super
引用记录是一个已解析的名称或（可能尚未解析的）属性绑定；其字段由
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Base]] | 一个 |
持有绑定的值或 |
| [[ReferencedName]] | 一个 |
绑定的名称。如果 [[Base]] 值是 |
| [[Strict]] | 一个布尔值 | 如果 |
| [[ThisValue]] | 一个 |
如果不是 super |
本规范中使用以下
6.2.5.1 IsPropertyReference ( V )
抽象操作 IsPropertyReference 接受参数 V（一个
- 如果 V.[[Base]] 是
unresolvable ，返回false 。 - 如果 V.[[Base]] 是
环境记录 ，返回false ；否则返回true 。
6.2.5.2 IsUnresolvableReference ( V )
抽象操作 IsUnresolvableReference 接受参数 V（一个
- 如果 V.[[Base]] 是
unresolvable ，返回true ；否则返回false 。
6.2.5.3 IsSuperReference ( V )
抽象操作 IsSuperReference 接受参数 V（一个
- 如果 V.[[ThisValue]] 不是
empty ，返回true ；否则返回false 。
6.2.5.4 IsPrivateReference ( V )
抽象操作 IsPrivateReference 接受参数 V（一个
- 如果 V.[[ReferencedName]] 是
私有名称 ，返回true ；否则返回false 。
6.2.5.5 GetValue ( V )
抽象操作 GetValue 接受参数 V（一个
- 如果 V 不是
引用记录 ，返回 V。 - 如果
IsUnresolvableReference (V) 是true ，抛出ReferenceError 异常。 - 如果
IsPropertyReference (V) 是true ，那么- 设 baseObj 为 ?
ToObject (V.[[Base]])。 - 如果
IsPrivateReference (V) 是true ，那么- 返回 ?
PrivateGet (baseObj, V.[[ReferencedName]])。
- 返回 ?
- 如果 V.[[ReferencedName]] 不是
属性键 ，那么- 设 V.[[ReferencedName]] 为
?
ToPropertyKey (V.[[ReferencedName]])。
- 设 V.[[ReferencedName]] 为
?
- 返回 ? baseObj.[[Get]](V.[[ReferencedName]],
GetThisValue (V))。
- 设 baseObj 为 ?
- 否则，
6.2.5.6 PutValue ( V, W )
抽象操作 PutValue 接受参数 V（一个
- 如果 V 不是
引用记录 ，抛出ReferenceError 异常。 - 如果
IsUnresolvableReference (V) 是true ，那么- 如果 V.[[Strict]] 是
true ，抛出ReferenceError 异常。 - 设 globalObj 为
GetGlobalObject ()。 - 执行 ?
Set (globalObj, V.[[ReferencedName]], W,false )。 - 返回
unused 。
- 如果 V.[[Strict]] 是
- 如果
IsPropertyReference (V) 是true ，那么- 设 baseObj 为 ?
ToObject (V.[[Base]])。 - 如果
IsPrivateReference (V) 是true ，那么- 返回 ?
PrivateSet (baseObj, V.[[ReferencedName]], W)。
- 返回 ?
- 如果 V.[[ReferencedName]] 不是
属性键 ，那么- 设 V.[[ReferencedName]] 为
?
ToPropertyKey (V.[[ReferencedName]])。
- 设 V.[[ReferencedName]] 为
?
- 设 succeeded 为 ? baseObj.[[Set]](V.[[ReferencedName]], W,
GetThisValue (V))。 - 如果 succeeded 是
false 且 V.[[Strict]] 是true ，抛出TypeError 异常。 - 返回
unused 。
- 设 baseObj 为 ?
- 否则，
6.2.5.7 GetThisValue ( V )
抽象操作 GetThisValue 接受参数 V（一个
断言 ：IsPropertyReference (V) 是true 。- 如果
IsSuperReference (V) 是true ，返回 V.[[ThisValue]]；否则返回 V.[[Base]]。
6.2.5.8 InitializeReferencedBinding ( V, W )
抽象操作 InitializeReferencedBinding 接受参数 V（一个
断言 ：IsUnresolvableReference (V) 是false 。- 设 base 为 V.[[Base]]。
断言 ：base 是环境记录 。- 返回 ? base.InitializeBinding(V.[[ReferencedName]], W)。
6.2.5.9 MakePrivateReference ( baseValue, privateIdentifier )
抽象操作 MakePrivateReference 接受参数 baseValue（一个
- 设 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 断言 ：privateEnv 不是null 。- 设 privateName 为
ResolvePrivateIdentifier (privateEnv, privateIdentifier)。 - 返回
引用记录 { [[Base]]: baseValue, [[ReferencedName]]: privateName, [[Strict]]:true , [[ThisValue]]:empty }。
6.2.6 属性描述符规范类型
属性描述符类型用于解释对象属性特性的操作和具体化。属性描述符是一个具有零个或多个字段的
属性描述符值可以根据某些字段的存在或使用进一步分类为数据属性描述符和访问器属性描述符。数据属性描述符是包含名为 [[Value]] 或 [[Writable]] 的任何字段的描述符。访问器属性描述符是包含名为 [[Get]] 或
[[Set]] 的任何字段的描述符。任何属性描述符都可以有名为 [[Enumerable]]
和 [[Configurable]]
的字段。属性描述符值不能既是数据属性描述符又是访问器属性描述符；但是，它可以两者都不是（在这种情况下它是通用属性描述符）。完全填充的属性描述符是访问器属性描述符或数据属性描述符，并且具有
本规范中使用以下
6.2.6.1 IsAccessorDescriptor ( Desc )
抽象操作 IsAccessorDescriptor 接受参数 Desc（一个
- 如果 Desc 有 [[Get]] 字段，返回
true 。 - 如果 Desc 有 [[Set]] 字段，返回
true 。 - 返回
false 。
6.2.6.2 IsDataDescriptor ( Desc )
抽象操作 IsDataDescriptor 接受参数 Desc（一个
- 如果 Desc 有 [[Value]] 字段，返回
true 。 - 如果 Desc 有 [[Writable]] 字段，返回
true 。 - 返回
false 。
6.2.6.3 IsGenericDescriptor ( Desc )
抽象操作 IsGenericDescriptor 接受参数 Desc（一个
- 如果
IsAccessorDescriptor (Desc) 是true ，返回false 。 - 如果
IsDataDescriptor (Desc) 是true ，返回false 。 - 返回
true 。
6.2.6.4 FromPropertyDescriptor ( Desc )
抽象操作 FromPropertyDescriptor 接受参数 Desc（一个
- 如果 Desc 是
undefined ，返回undefined 。 - 设 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 断言 ：obj 是一个可扩展的普通对象 ，没有自有属性。- 如果 Desc 有 [[Value]] 字段，那么
- 执行 !
CreateDataPropertyOrThrow (obj,"value" , Desc.[[Value]])。
- 执行 !
- 如果 Desc 有 [[Writable]] 字段，那么
- 执行 !
CreateDataPropertyOrThrow (obj,"writable" , Desc.[[Writable]])。
- 执行 !
- 如果 Desc 有 [[Get]] 字段，那么
- 执行 !
CreateDataPropertyOrThrow (obj,"get" , Desc.[[Get]])。
- 执行 !
- 如果 Desc 有 [[Set]] 字段，那么
- 执行 !
CreateDataPropertyOrThrow (obj,"set" , Desc.[[Set]])。
- 执行 !
- 如果 Desc 有 [[Enumerable]] 字段，那么
- 执行 !
CreateDataPropertyOrThrow (obj,"enumerable" , Desc.[[Enumerable]])。
- 执行 !
- 如果 Desc 有 [[Configurable]] 字段，那么
- 执行 !
CreateDataPropertyOrThrow (obj,"configurable" , Desc.[[Configurable]])。
- 执行 !
- 返回 obj。
6.2.6.5 ToPropertyDescriptor ( Obj )
抽象操作 ToPropertyDescriptor 接受参数 Obj（一个
- 如果 Obj
不是对象 ，抛出TypeError 异常。 - 设 desc 为一个新的
属性描述符 ，初始时没有字段。 - 设 hasEnumerable 为 ?
HasProperty (Obj,"enumerable" )。 - 如果 hasEnumerable 是
true ，那么 - 设 hasConfigurable 为 ?
HasProperty (Obj,"configurable" )。 - 如果 hasConfigurable 是
true ，那么 - 设 hasValue 为 ?
HasProperty (Obj,"value" )。 - 如果 hasValue 是
true ，那么- 设 value 为 ?
Get (Obj,"value" )。 - 设 desc.[[Value]] 为 value。
- 设 value 为 ?
- 设 hasWritable 为 ?
HasProperty (Obj,"writable" )。 - 如果 hasWritable 是
true ，那么 - 设 hasGet 为 ?
HasProperty (Obj,"get" )。 - 如果 hasGet 是
true ，那么- 设 getter 为 ?
Get (Obj,"get" )。 - 如果
IsCallable (getter) 是false 且 getter 不是undefined ，抛出TypeError 异常。 - 设 desc.[[Get]] 为 getter。
- 设 getter 为 ?
- 设 hasSet 为 ?
HasProperty (Obj,"set" )。 - 如果 hasSet 是
true ，那么- 设 setter 为 ?
Get (Obj,"set" )。 - 如果
IsCallable (setter) 是false 且 setter 不是undefined ，抛出TypeError 异常。 - 设 desc.[[Set]] 为 setter。
- 设 setter 为 ?
- 如果 desc 有 [[Get]] 字段或 desc 有 [[Set]] 字段，那么
- 如果 desc 有 [[Value]] 字段或 desc
有 [[Writable]] 字段，抛出
TypeError 异常。
- 如果 desc 有 [[Value]] 字段或 desc
有 [[Writable]] 字段，抛出
- 返回 desc。
6.2.6.6 CompletePropertyDescriptor ( Desc )
抽象操作 CompletePropertyDescriptor 接受参数 Desc（一个
- 设 like 为
记录 { [[Value]]:undefined , [[Writable]]:false , [[Get]]:undefined , [[Set]]:undefined , [[Enumerable]]:false , [[Configurable]]:false }。 - 如果
IsGenericDescriptor (Desc) 是true 或IsDataDescriptor (Desc) 是true ，那么- 如果 Desc 没有 [[Value]] 字段，设 Desc.[[Value]] 为 like.[[Value]]。
- 如果 Desc 没有 [[Writable]] 字段，设 Desc.[[Writable]] 为 like.[[Writable]]。
- 否则，
- 如果 Desc 没有 [[Get]] 字段，设 Desc.[[Get]] 为 like.[[Get]]。
- 如果 Desc 没有 [[Set]] 字段，设 Desc.[[Set]] 为 like.[[Set]]。
- 如果 Desc 没有 [[Enumerable]] 字段，设 Desc.[[Enumerable]] 为 like.[[Enumerable]]。
- 如果 Desc 没有 [[Configurable]] 字段，设 Desc.[[Configurable]] 为 like.[[Configurable]]。
- 返回
unused 。
6.2.7 环境记录规范类型
6.2.8 抽象闭包规范类型
抽象闭包规范类型用于引用算法步骤以及一系列值。抽象闭包是元值，使用函数调用样式调用，例如
closure(arg1, arg2)。与
在创建抽象闭包的算法步骤中，值使用动词"capture"后跟别名列表来捕获。当创建抽象闭包时，它捕获当时与每个别名关联的值。在指定调用抽象闭包时要执行的算法的步骤中，每个捕获的值都通过用于捕获该值的别名来引用。
如果抽象闭包返回
抽象闭包作为其他算法的一部分内联创建，如以下示例所示。
6.2.9 数据块
数据块规范类型用于描述一个不同且可变的字节大小（8位）数值序列。字节值是
为了在本规范中表示方便，可以使用类似数组的语法来访问数据块值的各个字节。此表示法将数据块值表示为基于 0 的
驻留在内存中且可以被多个
共享数据块的语义通过
本规范中使用以下
6.2.9.1 CreateByteDataBlock ( size )
抽象操作 CreateByteDataBlock 接受参数 size（一个非负
6.2.9.2 CreateSharedByteDataBlock ( size )
抽象操作 CreateSharedByteDataBlock 接受参数 size（一个非负
- 设 db 为一个新的
共享数据块 值，由 size 个字节组成。如果无法创建这样的共享数据块 ，抛出RangeError 异常。 - 设 execution 为
周围代理 的代理记录 的 [[CandidateExecution]] 字段。 - 设 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的代理事件记录 。 - 设 zero 为 « 0 »。
- 对于 db 的每个索引 i，执行
- 将
WriteSharedMemory { [[Order]]:init , [[NoTear]]:true , [[Block]]: db, [[ByteIndex]]: i, [[ElementSize]]: 1, [[Payload]]: zero } 追加到 eventsRecord.[[EventList]]。
- 将
- 返回 db。
6.2.9.3 CopyDataBlockBytes ( toBlock, toIndex, fromBlock, fromIndex, count )
抽象操作 CopyDataBlockBytes 接受参数 toBlock（一个
断言 ：fromBlock 和 toBlock 是不同的值。- 设 fromSize 为 fromBlock 中的字节数。
断言 ：fromIndex + count ≤ fromSize。- 设 toSize 为 toBlock 中的字节数。
断言 ：toIndex + count ≤ toSize。- 重复，当 count > 0 时，
- 如果 fromBlock 是
共享数据块 ，那么- 设 execution 为
周围代理 的代理记录 的 [[CandidateExecution]] 字段。 - 设 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的代理事件记录 。 - 设 bytes 为一个
列表 ，其唯一元素是一个非确定性选择的字节值 。 - 注意：在实现中，bytes 是底层硬件上非原子读取指令的结果。非确定性是
内存模型 对描述弱一致性硬件可观察行为的语义规定。 - 设 readEvent 为
ReadSharedMemory { [[Order]]:unordered , [[NoTear]]:true , [[Block]]: fromBlock, [[ByteIndex]]: fromIndex, [[ElementSize]]: 1 }。 - 将 readEvent 追加到 eventsRecord.[[EventList]]。
- 将
选择值记录 { [[Event]]: readEvent, [[ChosenValue]]: bytes } 追加到 execution.[[ChosenValues]]。 - 如果 toBlock 是
共享数据块 ，那么- 将
WriteSharedMemory { [[Order]]:unordered , [[NoTear]]:true , [[Block]]: toBlock, [[ByteIndex]]: toIndex, [[ElementSize]]: 1, [[Payload]]: bytes } 追加到 eventsRecord.[[EventList]]。
- 将
- 否则，
- 设 toBlock[toIndex] 为 bytes[0]。
- 设 execution 为
- 否则，
- 设 toIndex 为 toIndex + 1。
- 设 fromIndex 为 fromIndex + 1。
- 设 count 为 count - 1。
- 如果 fromBlock 是
- 返回
unused 。
6.2.10 PrivateElement 规范类型
PrivateElement 类型是一个
PrivateElement 类型的值是
| 字段名 | 出现该字段的 [[Kind]] 字段值 | 值 | 含义 |
|---|---|---|---|
| [[Key]] | 全部 | 一个 |
字段、方法或访问器的名称。 |
| [[Kind]] | 全部 | 元素的类型。 | |
| [[Value]] | 一个 |
字段的值。 | |
| [[Get]] | 一个 |
私有访问器的 getter。 | |
| [[Set]] | 一个 |
私有访问器的 setter。 |
6.2.11 ClassFieldDefinition 记录规范类型
ClassFieldDefinition 类型是一个
ClassFieldDefinition 类型的值是
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Name]] | 一个 |
字段的名称。 |
| [[Initializer]] | 一个 ECMAScript |
字段的初始化器（如果有）。 |
6.2.12 私有名称
私有名称规范类型用于描述一个全局唯一值（即使与其他私有名称在其他方面无法区分，该值也与任何其他私有名称不同），它表示私有类元素（字段、方法或访问器）的键。每个私有名称都有一个关联的不可变
[[Description]]，它
6.2.13 ClassStaticBlockDefinition 记录规范类型
ClassStaticBlockDefinition
记录是一个
ClassStaticBlockDefinition 记录具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[BodyFunction]] | 一个 ECMAScript |
在类的静态初始化期间要调用的 |
7 抽象操作
这些操作不是 ECMAScript 语言的一部分；定义它们仅是为了帮助说明 ECMAScript 语言的语义。其他更专门的
7.1 类型转换
ECMAScript 语言根据需要隐式执行自动类型转换。为了阐明某些构造的语义，定义一组转换
7.1.1 ToPrimitive ( input [ , preferredType ] )
抽象操作 ToPrimitive 接受参数 input（一个
- 如果 input
是对象 ，那么- 设 exoticToPrim 为 ?
GetMethod (input,%Symbol.toPrimitive% )。 - 如果 exoticToPrim 不是
undefined ，那么 - 如果 preferredType 不存在，设 preferredType 为
number 。 - 返回 ?
OrdinaryToPrimitive (input, preferredType)。
- 设 exoticToPrim 为 ?
- 返回 input。
当调用 ToPrimitive 时不带提示，那么它通常表现为提示是
7.1.1.1 OrdinaryToPrimitive ( O, hint )
抽象操作 OrdinaryToPrimitive 接受参数 O（一个对象）和
hint（
- 如果 hint 是
string ，那么- 设 methodNames 为 «
"toString" ,"valueOf" »。
- 设 methodNames 为 «
- 否则，
- 设 methodNames 为 «
"valueOf" ,"toString" »。
- 设 methodNames 为 «
- 对于 methodNames 的每个元素 name，执行
- 设 method 为 ?
Get (O, name)。 - 如果
IsCallable (method) 是true ，那么
- 设 method 为 ?
- 抛出
TypeError 异常。
7.1.2 ToBoolean ( argument )
抽象操作 ToBoolean 接受参数 argument（一个
7.1.3 ToNumeric ( value )
抽象操作 ToNumeric 接受参数 value（一个
- 设 primValue 为 ?
ToPrimitive (value,number )。 - 如果 primValue
是 BigInt ，返回 primValue。 - 返回 ?
ToNumber (primValue)。
7.1.4 ToNumber ( argument )
抽象操作 ToNumber 接受参数 argument（一个
- 如果 argument
是数字 ，返回 argument。 - 如果 argument 是符号或 BigInt，抛出
TypeError 异常。 - 如果 argument 是
undefined ，返回NaN 。 - 如果 argument 是
null 或false ，返回+0 𝔽。 - 如果 argument 是
true ，返回1 𝔽。 - 如果 argument
是字符串 ，返回StringToNumber (argument)。 断言 ：argument是对象 。- 设 primValue 为 ?
ToPrimitive (argument,number )。 断言 ：primValue不是对象 。- 返回 ?
ToNumber (primValue)。
7.1.4.1 ToNumber 应用于字符串类型
抽象操作
语法
所有未在上面明确定义的语法符号都具有数字字面量词法语法中使用的定义（
应注意
StringNumericLiteral 可能包含前导和/或尾随空白和/或行终止符。- 十进制的
StringNumericLiteral 可能有任意数量的前导0数字。 - 十进制的
StringNumericLiteral 可能包含+或-来表示其符号。 - 空的或只包含空白的
StringNumericLiteral 转换为+0 𝔽。 Infinity和-Infinity被识别为StringNumericLiteral 但不是NumericLiteral 。StringNumericLiteral 不能包含BigIntLiteralSuffix 。StringNumericLiteral 不能包含NumericLiteralSeparator 。
7.1.4.1.1 StringToNumber ( str )
抽象操作 StringToNumber 接受参数 str（一个字符串）并返回一个数字。它在被调用时执行以下步骤：
- 设 literal 为
ParseText (str,StringNumericLiteral )。 - 如果 literal 是错误的
列表 ，返回NaN 。 - 返回 literal 的
StringNumericValue 。
7.1.4.1.2 运行时语义：StringNumericValue
它在以下产生式上分段定义：
- 返回
+0 𝔽。
- 返回
𝔽 (NonDecimalIntegerLiteral 的 MV)。
- 设 a 为
StrUnsignedDecimalLiteral 的StringNumericValue 。 - 如果 a 是
+0 𝔽，返回-0 𝔽。 - 返回 -a。
- 返回
+∞ 𝔽。
- 设 a 为第一个
DecimalDigits 的 MV。 - 如果第二个
DecimalDigits 存在，那么- 设 b 为第二个
DecimalDigits 的 MV。 - 设 n 为第二个
DecimalDigits 中的代码点数。
- 设 b 为第二个
- 否则，
- 设 b 为 0。
- 设 n 为 0。
- 如果
ExponentPart 存在，设 e 为ExponentPart 的 MV。否则，设 e 为 0。 - 返回
RoundMVResult ((a + (b × 10-n)) × 10e)。
- 设 b 为
DecimalDigits 的 MV。 - 如果
ExponentPart 存在，设 e 为ExponentPart 的 MV。否则，设 e 为 0。 - 设 n 为
DecimalDigits 中的代码点数。 - 返回
RoundMVResult (b × 10e - n)。
- 设 a 为
DecimalDigits 的 MV。 - 如果
ExponentPart 存在，设 e 为ExponentPart 的 MV。否则，设 e 为 0。 - 返回
RoundMVResult (a × 10e)。
7.1.4.1.3 RoundMVResult ( n )
抽象操作 RoundMVResult 接受参数 n（一个
7.1.5 ToIntegerOrInfinity ( argument )
抽象操作 ToIntegerOrInfinity 接受参数 argument（一个
7.1.6 ToInt32 ( argument )
抽象操作 ToInt32 接受参数 argument（一个
根据 ToInt32 的上述定义：
- ToInt32 抽象操作是幂等的：如果应用于它产生的结果，第二次应用不会改变该值。
- 对于所有值 x，ToInt32(
ToUint32 (x)) 与 ToInt32(x) 是相同的值。（为了保持这个后续属性，+∞ 𝔽 和-∞ 𝔽 被映射为+0 𝔽。） - ToInt32 将
-0 𝔽 映射为+0 𝔽。
7.1.7 ToUint32 ( argument )
抽象操作 ToUint32 接受参数 argument（一个
7.1.8 ToInt16 ( argument )
抽象操作 ToInt16 接受参数 argument（一个
7.1.9 ToUint16 ( argument )
抽象操作 ToUint16 接受参数 argument（一个
7.1.10 ToInt8 ( argument )
抽象操作 ToInt8 接受参数 argument（一个
7.1.11 ToUint8 ( argument )
抽象操作 ToUint8 接受参数 argument（一个
7.1.12 ToUint8Clamp ( argument )
抽象操作 ToUint8Clamp 接受参数 argument（一个
与大多数其他 ECMAScript Math.round
7.1.13 ToBigInt ( argument )
抽象操作 ToBigInt 接受参数 argument（一个
- 设 prim 为 ?
ToPrimitive (argument,number )。 - 返回 prim 在
表 12 中对应的值。
| 参数类型 | 结果 |
|---|---|
| Undefined | 抛出 |
| Null | 抛出 |
| Boolean | 如果 prim 是 1n，如果
prim 是 0n。
|
| BigInt | 返回 prim。 |
| Number | 抛出 |
| String |
|
| Symbol | 抛出 |
7.1.14 StringToBigInt ( str )
抽象操作 StringToBigInt 接受参数 str（一个字符串）并返回一个 BigInt 或
7.1.14.1 StringIntegerLiteral 语法
语法
7.1.14.2 运行时语义：MV
StringIntegerLiteral ::: StrWhiteSpace opt StringIntegerLiteral ::: StrWhiteSpace opt StrIntegerLiteral StrWhiteSpace opt StrIntegerLiteral 的 MV。
7.1.15 ToBigInt64 ( argument )
抽象操作 ToBigInt64 接受参数 argument（一个
7.1.16 ToBigUint64 ( argument )
抽象操作 ToBigUint64 接受参数 argument（一个
7.1.17 ToString ( argument )
抽象操作 ToString 接受参数 argument（一个
- 如果 argument
是字符串 ，返回 argument。 - 如果 argument
是符号 ，抛出TypeError 异常。 - 如果 argument 是
undefined ，返回"undefined" 。 - 如果 argument 是
null ，返回"null" 。 - 如果 argument 是
true ，返回"true" 。 - 如果 argument 是
false ，返回"false" 。 - 如果 argument
是数字 ，返回Number::toString (argument, 10)。 - 如果 argument
是 BigInt ，返回BigInt::toString (argument, 10)。 断言 ：argument是对象 。- 设 primValue 为 ?
ToPrimitive (argument,string )。 断言 ：primValue不是对象 。- 返回 ?
ToString (primValue)。
7.1.18 ToObject ( argument )
抽象操作 ToObject 接受参数 argument（一个
| 参数类型 | 结果 |
|---|---|
| Undefined | 抛出 |
| Null | 抛出 |
| Boolean | 返回一个新的布尔对象，其 [[BooleanData]] 内部槽设置为
argument。有关布尔对象的描述，请参见 |
| Number | 返回一个新的数字对象，其 [[NumberData]] 内部槽设置为
argument。有关数字对象的描述，请参见 |
| String | 返回一个新的字符串对象，其 [[StringData]] 内部槽设置为
argument。有关字符串对象的描述，请参见 |
| Symbol | 返回一个新的符号对象，其 [[SymbolData]] 内部槽设置为
argument。有关符号对象的描述，请参见 |
| BigInt | 返回一个新的 BigInt 对象，其 [[BigIntData]] 内部槽设置为
argument。有关 BigInt 对象的描述，请参见 |
| Object | 返回 argument。 |
7.1.19 ToPropertyKey ( argument )
抽象操作 ToPropertyKey 接受参数 argument（一个
- 设 key 为 ?
ToPrimitive (argument,string )。 - 如果 key
是符号 ，那么- 返回 key。
- 返回 !
ToString (key)。
7.1.20 ToLength ( argument )
抽象操作 ToLength 接受参数 argument（一个
- 设 len 为 ?
ToIntegerOrInfinity (argument)。 - 如果 len ≤ 0，返回
+0 𝔽。 - 返回
𝔽 (min (len, 253 - 1))。
7.1.21 CanonicalNumericIndexString ( argument )
抽象操作 CanonicalNumericIndexString 接受参数 argument（一个字符串）并返回一个数字或
规范数字字符串是 CanonicalNumericIndexString 抽象操作不返回
7.1.22 ToIndex ( value )
抽象操作 ToIndex 接受参数 value（一个
- 设 integer 为 ?
ToIntegerOrInfinity (value)。 - 如果 integer 不在从 0 到 253 - 1 的
闭区间 内，抛出RangeError 异常。 - 返回 integer。
7.2 测试和比较操作
7.2.1 RequireObjectCoercible ( argument )
抽象操作 RequireObjectCoercible 接受参数 argument（一个
| 参数类型 | 结果 |
|---|---|
| Undefined | 抛出 |
| Null | 抛出 |
| Boolean | 返回 argument。 |
| Number | 返回 argument。 |
| String | 返回 argument。 |
| Symbol | 返回 argument。 |
| BigInt | 返回 argument。 |
| Object | 返回 argument。 |
7.2.2 IsArray ( argument )
抽象操作 IsArray 接受参数 argument（一个
- 如果 argument
不是对象 ，返回false 。 - 如果 argument 是
数组异质对象 ，返回true 。 - 如果 argument 是
代理异质对象 ，那么- 执行 ?
ValidateNonRevokedProxy (argument)。 - 设 proxyTarget 为 argument.[[ProxyTarget]]。
- 返回 ?
IsArray (proxyTarget)。
- 执行 ?
- 返回
false 。
7.2.3 IsCallable ( argument )
抽象操作 IsCallable 接受参数 argument（一个
- 如果 argument
不是对象 ，返回false 。 - 如果 argument 有 [[Call]] 内部方法，返回
true 。 - 返回
false 。
7.2.4 IsConstructor ( argument )
抽象操作 IsConstructor 接受参数 argument（一个
- 如果 argument
不是对象 ，返回false 。 - 如果 argument 有 [[Construct]] 内部方法，返回
true 。 - 返回
false 。
7.2.5 IsExtensible ( O )
抽象操作 IsExtensible 接受参数 O（一个对象）并返回一个
- 返回 ? O.[[IsExtensible]]()。
7.2.6 IsRegExp ( argument )
抽象操作 IsRegExp 接受参数 argument（一个
- 如果 argument
不是对象 ，返回false 。 - 设 matcher 为 ?
Get (argument,%Symbol.match% )。 - 如果 matcher 不是
undefined ，返回ToBoolean (matcher)。 - 如果 argument 有 [[RegExpMatcher]] 内部槽，返回
true 。 - 返回
false 。
7.2.7 静态语义：IsStringWellFormedUnicode ( string )
抽象操作 IsStringWellFormedUnicode 接受参数 string（一个字符串）并返回一个布尔值。它将 string 解释为
UTF-16 编码代码点的序列，如
- 设 len 为 string 的长度。
- 设 k 为 0。
- 重复，当 k < len 时，
- 设 cp 为
CodePointAt (string, k)。 - 如果 cp.[[IsUnpairedSurrogate]] 是
true ，返回false 。 - 设 k 为 k + cp.[[CodeUnitCount]]。
- 设 cp 为
- 返回
true 。
7.2.8 SameType ( x, y )
抽象操作 SameType 接受参数 x（一个
7.2.9 SameValue ( x, y )
抽象操作 SameValue 接受参数 x（一个
- 如果
SameType (x, y) 是false ，返回false 。 - 如果 x
是数字 ，那么- 返回
Number::sameValue (x, y)。
- 返回
- 返回
SameValueNonNumber (x, y)。
此算法与
7.2.10 SameValueZero ( x, y )
抽象操作 SameValueZero 接受参数 x（一个
- 如果
SameType (x, y) 是false ，返回false 。 - 如果 x
是数字 ，那么- 返回
Number::sameValueZero (x, y)。
- 返回
- 返回
SameValueNonNumber (x, y)。
SameValueZero 与
7.2.11 SameValueNonNumber ( x, y )
抽象操作 SameValueNonNumber 接受参数 x（一个
断言 ：SameType (x, y) 是true 。- 如果 x 是
null 或undefined ，返回true 。 - 如果 x
是 BigInt ，那么- 返回
BigInt::equal (x, y)。
- 返回
- 如果 x
是字符串 ，那么- 如果 x 和 y 有相同的长度且在相同位置有相同的代码单元，返回
true ；否则，返回false 。
- 如果 x 和 y 有相同的长度且在相同位置有相同的代码单元，返回
- 如果 x
是布尔值 ，那么- 如果 x 和 y 都是
true 或都是false ，返回true ；否则，返回false 。
- 如果 x 和 y 都是
- 注意：所有其他
ECMAScript 语言值 按标识进行比较。 - 如果 x 是 y，返回
true ；否则，返回false 。
7.2.12 IsLessThan ( x, y, LeftFirst )
抽象操作 IsLessThan 接受参数 x（一个
- 如果 LeftFirst 是
true ，那么- 设 px 为 ?
ToPrimitive (x,number )。 - 设 py 为 ?
ToPrimitive (y,number )。
- 设 px 为 ?
- 否则，
- 注意：需要颠倒求值顺序以保持从左到右的求值。
- 设 py 为 ?
ToPrimitive (y,number )。 - 设 px 为 ?
ToPrimitive (x,number )。
- 如果 px
是字符串 且 py是字符串 ，那么 - 否则，
- 如果 px
是 BigInt 且 py是字符串 ，那么- 设 ny 为
StringToBigInt (py)。 - 如果 ny 是
undefined ，返回undefined 。 - 返回
BigInt::lessThan (px, ny)。
- 设 ny 为
- 如果 px
是字符串 且 py是 BigInt ，那么- 设 nx 为
StringToBigInt (px)。 - 如果 nx 是
undefined ，返回undefined 。 - 返回
BigInt::lessThan (nx, py)。
- 设 nx 为
- 注意：因为 px 和 py 是原始值，求值顺序不重要。
- 设 nx 为 ?
ToNumeric (px)。 - 设 ny 为 ?
ToNumeric (py)。 - 如果
SameType (nx, ny) 是true ，那么- 如果 nx
是数字 ，那么- 返回
Number::lessThan (nx, ny)。
- 返回
- 否则，
断言 ：nx是 BigInt 。- 返回
BigInt::lessThan (nx, ny)。
- 如果 nx
断言 ：nx是 BigInt 且 ny是数字 ，或 nx是数字 且 ny是 BigInt 。- 如果 nx 或 ny 是
NaN ，返回undefined 。 - 如果 nx 是
-∞ 𝔽 或 ny 是+∞ 𝔽，返回true 。 - 如果 nx 是
+∞ 𝔽 或 ny 是-∞ 𝔽，返回false 。 - 如果
ℝ (nx) <ℝ (ny)，返回true ；否则返回false 。
- 如果 px
字符串的比较使用 UTF-16 代码单元值序列的简单字典序。没有尝试使用 Unicode 规范中定义的更复杂的、面向语义的字符或字符串相等性和整理顺序定义。因此，根据
Unicode 标准规范相等但不在相同规范化形式中的字符串值可能测试为不相等。还要注意，对于包含
7.2.13 IsLooselyEqual ( x, y )
抽象操作 IsLooselyEqual 接受参数 x（一个== 运算符提供语义。它在被调用时执行以下步骤：
- 如果
SameType (x, y) 是true ，那么- 返回
IsStrictlyEqual (x, y)。
- 返回
- 如果 x 是
null 且 y 是undefined ，返回true 。 - 如果 x 是
undefined 且 y 是null ，返回true 。 - 注意：此步骤在
B.3.6.2 节中被替换。 - 如果 x
是数字 且 y是字符串 ，返回 !IsLooselyEqual (x, !ToNumber (y))。 - 如果 x
是字符串 且 y是数字 ，返回 !IsLooselyEqual (!ToNumber (x), y)。 - 如果 x
是 BigInt 且 y是字符串 ，那么- 设 n 为
StringToBigInt (y)。 - 如果 n 是
undefined ，返回false 。 - 返回 !
IsLooselyEqual (x, n)。
- 设 n 为
- 如果 x
是字符串 且 y是 BigInt ，返回 !IsLooselyEqual (y, x)。 - 如果 x
是布尔值 ，返回 !IsLooselyEqual (!ToNumber (x), y)。 - 如果 y
是布尔值 ，返回 !IsLooselyEqual (x, !ToNumber (y))。 - 如果 x 是字符串、数字、BigInt 或符号，且 y
是对象 ，返回 !IsLooselyEqual (x, ?ToPrimitive (y))。 - 如果 x
是对象 且 y 是字符串、数字、BigInt 或符号，返回 !IsLooselyEqual (?ToPrimitive (x), y)。 - 如果 x
是 BigInt 且 y是数字 ，或如果 x是数字 且 y是 BigInt ，那么 - 返回
false 。
7.2.14 IsStrictlyEqual ( x, y )
抽象操作 IsStrictlyEqual 接受参数 x（一个=== 运算符提供语义。它在被调用时执行以下步骤：
- 如果
SameType (x, y) 是false ，返回false 。 - 如果 x
是数字 ，那么- 返回
Number::equal (x, y)。
- 返回
- 返回
SameValueNonNumber (x, y)。
此算法与
7.3 对象操作
7.3.1 MakeBasicObject ( internalSlotsList )
抽象操作 MakeBasicObject 接受参数 internalSlotsList（一个内部槽名称的
- 设 internalSlotsList 为 internalSlotsList 和 « [[PrivateElements]] » 的
列表连接 。 - 设 obj 为一个新创建的对象，为 internalSlotsList 中的每个名称都有一个内部槽。
- 注意：如
对象内部方法和内部槽 中所述，除非另有规定，每个这样的内部槽的初始值都是undefined 。 - 设 obj.[[PrivateElements]] 为一个新的空
列表 。 - 将 obj 的基本内部方法设置为
10.1 中指定的默认普通对象 定义。 断言 ：如果调用者不会覆盖 obj 的 [[GetPrototypeOf]] 和 [[SetPrototypeOf]] 基本内部方法，那么 internalSlotsList 包含 [[Prototype]]。断言 ：如果调用者不会覆盖 obj 的所有 [[SetPrototypeOf]]、[[IsExtensible]] 和 [[PreventExtensions]] 基本内部方法，那么 internalSlotsList 包含 [[Extensible]]。- 如果 internalSlotsList 包含 [[Extensible]]，设
obj.[[Extensible]] 为
true 。 - 返回 obj。
在本规范中，
7.3.2 Get ( O, P )
抽象操作 Get 接受参数 O（一个对象）和 P（一个
- 返回 ? O.[[Get]](P, O)。
7.3.3 GetV ( V, P )
抽象操作 GetV 接受参数 V（一个
- 设 O 为 ?
ToObject (V)。 - 返回 ? O.[[Get]](P, V)。
7.3.4 Set ( O, P, V, Throw )
抽象操作 Set 接受参数 O（一个对象）、P（一个
- 设 success 为 ? O.[[Set]](P, V, O)。
- 如果 success 是
false 且 Throw 是true ，抛出TypeError 异常。 - 返回
unused 。
7.3.5 CreateDataProperty ( O, P, V )
抽象操作 CreateDataProperty 接受参数 O（一个对象）、P（一个
- 设 newDesc 为 PropertyDescriptor { [[Value]]:
V, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:true }。 - 返回 ? O.[[DefineOwnProperty]](P, newDesc)。
此抽象操作创建一个属性，其特性设置为与 ECMAScript 语言赋值运算符创建的属性相同的默认值。通常，该属性还不存在。如果它存在且不可配置，或者如果 O
不可扩展，[[DefineOwnProperty]] 将返回
7.3.6 CreateDataPropertyOrThrow ( O, P, V )
抽象操作 CreateDataPropertyOrThrow 接受参数 O（一个对象）、P（一个
- 设 success 为 ?
CreateDataProperty (O, P, V)。 - 如果 success 是
false ，抛出TypeError 异常。 - 返回
unused 。
此抽象操作创建一个属性，其特性设置为与 ECMAScript 语言赋值运算符创建的属性相同的默认值。通常，该属性还不存在。如果它存在且不可配置，或者如果 O
不可扩展，[[DefineOwnProperty]] 将返回
7.3.7 CreateNonEnumerableDataPropertyOrThrow ( O, P, V )
抽象操作 CreateNonEnumerableDataPropertyOrThrow 接受参数 O（一个对象）、P（一个
断言 ：O 是一个普通的、可扩展的、没有不可配置属性的对象。- 设 newDesc 为 PropertyDescriptor { [[Value]]:
V, [[Writable]]:
true , [[Enumerable]]:false , [[Configurable]]:true }。 - 执行 !
DefinePropertyOrThrow (O, P, newDesc)。 - 返回
unused 。
此抽象操作创建一个属性，其特性设置为与 ECMAScript 语言赋值运算符创建的属性相同的默认值，但它不可枚举。通常，该属性还不存在。如果它存在，
7.3.8 DefinePropertyOrThrow ( O, P, desc )
抽象操作 DefinePropertyOrThrow 接受参数 O（一个对象）、P（一个
- 设 success 为 ? O.[[DefineOwnProperty]](P, desc)。
- 如果 success 是
false ，抛出TypeError 异常。 - 返回
unused 。
7.3.9 DeletePropertyOrThrow ( O, P )
抽象操作 DeletePropertyOrThrow 接受参数 O（一个对象）和 P（一个
- 设 success 为 ? O.[[Delete]](P)。
- 如果 success 是
false ，抛出TypeError 异常。 - 返回
unused 。
7.3.10 GetMethod ( V, P )
抽象操作 GetMethod 接受参数 V（一个
- 设 func 为 ?
GetV (V, P)。 - 如果 func 是
undefined 或null ，返回undefined 。 - 如果
IsCallable (func) 是false ，抛出TypeError 异常。 - 返回 func。
7.3.11 HasProperty ( O, P )
抽象操作 HasProperty 接受参数 O（一个对象）和 P（一个
- 返回 ? O.[[HasProperty]](P)。
7.3.12 HasOwnProperty ( O, P )
抽象操作 HasOwnProperty 接受参数 O（一个对象）和 P（一个
- 设 desc 为 ? O.[[GetOwnProperty]](P)。
- 如果 desc 是
undefined ，返回false 。 - 返回
true 。
7.3.13 Call ( F, V [ , argumentsList ] )
抽象操作 Call 接受参数 F（一个
- 如果 argumentsList 不存在，设 argumentsList 为一个新的空
列表 。 - 如果
IsCallable (F) 是false ，抛出TypeError 异常。 - 返回 ? F.[[Call]](V, argumentsList)。
7.3.14 Construct ( F [ , argumentsList [ , newTarget ] ] )
抽象操作 Construct 接受参数 F（一个
- 如果 newTarget 不存在，设 newTarget 为 F。
- 如果 argumentsList 不存在，设 argumentsList 为一个新的空
列表 。 - 返回 ? F.[[Construct]](argumentsList, newTarget)。
如果 newTarget 不存在，此操作等价于：new F(...argumentsList)
7.3.15 SetIntegrityLevel ( O, level )
抽象操作 SetIntegrityLevel 接受参数 O（一个对象）和 level（
- 设 status 为 ? O.[[PreventExtensions]]()。
- 如果 status 是
false ，返回false 。 - 设 keys 为 ? O.[[OwnPropertyKeys]]()。
- 如果 level 是
sealed ，那么- 对于 keys 的每个元素 k，执行
- 执行 ?
DefinePropertyOrThrow (O, k, PropertyDescriptor { [[Configurable]]:false })。
- 执行 ?
- 对于 keys 的每个元素 k，执行
- 否则，
断言 ：level 是frozen 。- 对于 keys 的每个元素 k，执行
- 设 currentDesc 为 ? O.[[GetOwnProperty]](k)。
- 如果 currentDesc 不是
undefined ，那么- 如果
IsAccessorDescriptor (currentDesc) 是true ，那么- 设 desc 为 PropertyDescriptor { [[Configurable]]:
false }。
- 设 desc 为 PropertyDescriptor { [[Configurable]]:
- 否则，
- 设 desc 为 PropertyDescriptor { [[Configurable]]:
false , [[Writable]]:false }。
- 设 desc 为 PropertyDescriptor { [[Configurable]]:
- 执行 ?
DefinePropertyOrThrow (O, k, desc)。
- 如果
- 返回
true 。
7.3.16 TestIntegrityLevel ( O, level )
抽象操作 TestIntegrityLevel 接受参数 O（一个对象）和 level（
- 设 extensible 为 ?
IsExtensible (O)。 - 如果 extensible 是
true ，返回false 。 - 注意：如果对象是可扩展的，则不检查其任何属性。
- 设 keys 为 ? O.[[OwnPropertyKeys]]()。
- 对于 keys 的每个元素 k，执行
- 设 currentDesc 为 ? O.[[GetOwnProperty]](k)。
- 如果 currentDesc 不是
undefined ，那么- 如果 currentDesc.[[Configurable]] 是
true ，返回false 。 - 如果 level 是
frozen 且IsDataDescriptor (currentDesc) 是true ，那么- 如果 currentDesc.[[Writable]]
是
true ，返回false 。
- 如果 currentDesc.[[Writable]]
是
- 如果 currentDesc.[[Configurable]] 是
- 返回
true 。
7.3.17 CreateArrayFromList ( elements )
抽象操作 CreateArrayFromList 接受参数 elements（一个
- 设 array 为 !
ArrayCreate (0)。 - 设 n 为 0。
- 对于 elements 的每个元素 e，执行
- 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), e)。 - 设 n 为 n + 1。
- 执行 !
- 返回 array。
7.3.18 LengthOfArrayLike ( obj )
抽象操作 LengthOfArrayLike 接受参数 obj（一个对象）并返回一个
类数组对象是此操作返回
7.3.19 CreateListFromArrayLike ( obj [ , validElementTypes ] )
抽象操作 CreateListFromArrayLike 接受参数 obj（一个
- 如果 validElementTypes 不存在，设 validElementTypes 为
all 。 - 如果 obj
不是对象 ，抛出TypeError 异常。 - 设 len 为 ?
LengthOfArrayLike (obj)。 - 设 list 为一个新的空
列表 。 - 设 index 为 0。
- 重复，当 index < len 时，
- 返回 list。
7.3.20 Invoke ( V, P [ , argumentsList ] )
抽象操作 Invoke 接受参数 V（一个
7.3.21 OrdinaryHasInstance ( C, O )
抽象操作 OrdinaryHasInstance 接受参数 C（一个
- 如果
IsCallable (C) 是false ，返回false 。 - 如果 C 有 [[BoundTargetFunction]] 内部槽，那么
- 设 BC 为 C.[[BoundTargetFunction]]。
- 返回 ?
InstanceofOperator (O, BC)。
- 如果 O
不是对象 ，返回false 。 - 设 P 为 ?
Get (C,"prototype" )。 - 如果 P
不是对象 ，抛出TypeError 异常。 - 重复，
- 设 O 为 ? O.[[GetPrototypeOf]]()。
- 如果 O 是
null ，返回false 。 - 如果
SameValue (P, O) 是true ，返回true 。
7.3.22 SpeciesConstructor ( O, defaultConstructor )
抽象操作 SpeciesConstructor 接受参数 O（一个对象）和 defaultConstructor（一个
- 设 C 为 ?
Get (O,"constructor" )。 - 如果 C 是
undefined ，返回 defaultConstructor。 - 如果 C
不是对象 ，抛出TypeError 异常。 - 设 S 为 ?
Get (C,%Symbol.species% )。 - 如果 S 是
undefined 或null ，返回 defaultConstructor。 - 如果
IsConstructor (S) 是true ，返回 S。 - 抛出
TypeError 异常。
7.3.23 EnumerableOwnProperties ( O, kind )
抽象操作 EnumerableOwnProperties 接受参数 O（一个对象）和
kind（
- 设 ownKeys 为 ? O.[[OwnPropertyKeys]]()。
- 设 results 为一个新的空
列表 。 - 对于 ownKeys 的每个元素 key，执行
- 如果 key
是字符串 ，那么- 设 desc 为 ? O.[[GetOwnProperty]](key)。
- 如果 desc 不是
undefined 且 desc.[[Enumerable]] 是true ，那么- 如果 kind 是
key ，那么- 将 key 追加到 results。
- 否则，
- 设 value 为 ?
Get (O, key)。 - 如果 kind 是
value ，那么- 将 value 追加到 results。
- 否则，
断言 ：kind 是key+value 。- 设 entry 为
CreateArrayFromList (« key, value »)。 - 将 entry 追加到 results。
- 设 value 为 ?
- 如果 kind 是
- 如果 key
- 返回 results。
7.3.24 GetFunctionRealm ( obj )
抽象操作 GetFunctionRealm 接受参数 obj（一个
- 如果 obj 有 [[Realm]] 内部槽，那么
- 返回 obj.[[Realm]]。
- 如果 obj 是
绑定函数异质对象 ，那么- 设 boundTargetFunction 为 obj.[[BoundTargetFunction]]。
- 返回 ?
GetFunctionRealm (boundTargetFunction)。
- 如果 obj 是
代理异质对象 ，那么- 执行 ?
ValidateNonRevokedProxy (obj)。 - 设 proxyTarget 为 obj.[[ProxyTarget]]。
断言 ：proxyTarget 是一个函数对象 。- 返回 ?
GetFunctionRealm (proxyTarget)。
- 执行 ?
- 返回
当前 Realm Record 。
7.3.25 CopyDataProperties ( target, source, excludedItems )
抽象操作 CopyDataProperties 接受参数 target（一个对象）、source（一个
- 如果 source 是
undefined 或null ，返回unused 。 - 设 from 为 !
ToObject (source)。 - 设 keys 为 ? from.[[OwnPropertyKeys]]()。
- 对于 keys 的每个元素 nextKey，执行
- 设 excluded 为
false 。 - 对于 excludedItems 的每个元素 e，执行
- 如果
SameValue (e, nextKey) 是true ，那么- 设 excluded 为
true 。
- 设 excluded 为
- 如果
- 如果 excluded 是
false ，那么- 设 desc 为 ? from.[[GetOwnProperty]](nextKey)。
- 如果 desc 不是
undefined 且 desc.[[Enumerable]] 是true ，那么- 设 propValue 为 ?
Get (from, nextKey)。 - 执行 !
CreateDataPropertyOrThrow (target, nextKey, propValue)。
- 设 propValue 为 ?
- 设 excluded 为
- 返回
unused 。
这里传入的目标总是一个新创建的对象，在抛出错误的情况下不能直接访问。
7.3.26 PrivateElementFind ( O, P )
抽象操作 PrivateElementFind 接受参数 O（一个对象）和 P（一个
- 如果 O.[[PrivateElements]] 包含一个
PrivateElement pe，其中 pe.[[Key]] 是 P，那么- 返回 pe。
- 返回
empty 。
7.3.27 PrivateFieldAdd ( O, P, value )
抽象操作 PrivateFieldAdd 接受参数 O（一个对象）、P（一个
- 如果
宿主 是 Web 浏览器，那么- 执行 ?
HostEnsureCanAddPrivateElement (O)。
- 执行 ?
- 设 entry 为
PrivateElementFind (O, P)。 - 如果 entry 不是
empty ，抛出TypeError 异常。 - 将
PrivateElement { [[Key]]: P, [[Kind]]:field , [[Value]]: value } 追加到 O.[[PrivateElements]]。 - 返回
unused 。
7.3.28 PrivateMethodOrAccessorAdd ( O, method )
抽象操作 PrivateMethodOrAccessorAdd 接受参数 O（一个对象）和 method（一个
断言 ：method.[[Kind]] 是method 或accessor 。- 如果
宿主 是 Web 浏览器，那么- 执行 ?
HostEnsureCanAddPrivateElement (O)。
- 执行 ?
- 设 entry 为
PrivateElementFind (O, method.[[Key]])。 - 如果 entry 不是
empty ，抛出TypeError 异常。 - 将 method 追加到 O.[[PrivateElements]]。
- 返回
unused 。
私有方法和访问器的值在实例之间共享。此操作不会创建方法或访问器的新副本。
7.3.29 HostEnsureCanAddPrivateElement ( O )
HostEnsureCanAddPrivateElement 的实现必须符合以下要求：
- 如果 O 不是
宿主定义的 异质对象 ，此抽象操作必须返回NormalCompletion (unused ) 且不执行其他步骤。 - 使用相同参数对此抽象操作的任何两次调用必须返回相同类型的
完成记录 。
HostEnsureCanAddPrivateElement 的默认实现是返回
此抽象操作仅由作为 Web 浏览器的 ECMAScript
7.3.30 PrivateGet ( O, P )
抽象操作 PrivateGet 接受参数 O（一个对象）和 P（一个
- 设 entry 为
PrivateElementFind (O, P)。 - 如果 entry 是
empty ，抛出TypeError 异常。 - 如果 entry.[[Kind]] 是
field 或method ，那么- 返回 entry.[[Value]]。
断言 ：entry.[[Kind]] 是accessor 。- 如果 entry.[[Get]] 是
undefined ，抛出TypeError 异常。 - 设 getter 为 entry.[[Get]]。
- 返回 ?
Call (getter, O)。
7.3.31 PrivateSet ( O, P, value )
抽象操作 PrivateSet 接受参数 O（一个对象）、P（一个
- 设 entry 为
PrivateElementFind (O, P)。 - 如果 entry 是
empty ，抛出TypeError 异常。 - 如果 entry.[[Kind]] 是
field ，那么- 设 entry.[[Value]] 为 value。
- 否则如果 entry.[[Kind]] 是
method ，那么- 抛出
TypeError 异常。
- 抛出
- 否则，
- 返回
unused 。
7.3.32 DefineField ( receiver, fieldRecord )
抽象操作 DefineField 接受参数 receiver（一个对象）和 fieldRecord（一个
- 设 fieldName 为 fieldRecord.[[Name]]。
- 设 initializer 为 fieldRecord.[[Initializer]]。
- 如果 initializer 不是
empty ，那么- 设 initValue 为 ?
Call (initializer, receiver)。
- 设 initValue 为 ?
- 否则，
- 设 initValue 为
undefined 。
- 设 initValue 为
- 如果 fieldName 是
私有名称 ，那么- 执行 ?
PrivateFieldAdd (receiver, fieldName, initValue)。
- 执行 ?
- 否则，
断言 ：fieldName 是一个属性键 。- 执行 ?
CreateDataPropertyOrThrow (receiver, fieldName, initValue)。
- 返回
unused 。
7.3.33 InitializeInstanceElements ( O, constructor )
抽象操作 InitializeInstanceElements 接受参数 O（一个对象）和 constructor（一个 ECMAScript
- 设 methods 为 constructor.[[PrivateMethods]] 的值。
- 对于 methods 的每个
PrivateElement method，执行- 执行 ?
PrivateMethodOrAccessorAdd (O, method)。
- 执行 ?
- 设 fields 为 constructor.[[Fields]] 的值。
- 对于 fields 的每个元素 fieldRecord，执行
- 执行 ?
DefineField (O, fieldRecord)。
- 执行 ?
- 返回
unused 。
7.3.34 AddValueToKeyedGroup ( groups, key, value )
抽象操作 AddValueToKeyedGroup 接受参数 groups（一个
7.3.35 GroupBy ( items, callback, keyCoercion )
抽象操作 GroupBy 接受参数 items（一个
- 执行 ?
RequireObjectCoercible (items)。 - 如果
IsCallable (callback) 是false ，抛出TypeError 异常。 - 设 groups 为一个新的空
列表 。 - 设 iteratorRecord 为 ?
GetIterator (items,sync )。 - 设 k 为 0。
- 重复，
- 如果 k ≥ 253 - 1，那么
- 设 error 为
ThrowCompletion (新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iteratorRecord, error)。
- 设 error 为
- 设 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，那么- 返回 groups。
- 设 value 为 next。
- 设 key 为
Completion (Call (callback,undefined , « value,𝔽 (k) »))。 IfAbruptCloseIterator (key, iteratorRecord)。- 如果 keyCoercion 是
property ，那么- 设 key 为
Completion (ToPropertyKey (key))。 IfAbruptCloseIterator (key, iteratorRecord)。
- 设 key 为
- 否则，
断言 ：keyCoercion 是collection 。- 设 key 为
CanonicalizeKeyedCollectionKey (key)。
- 执行
AddValueToKeyedGroup (groups, key, value)。 - 设 k 为 k + 1。
- 如果 k ≥ 253 - 1，那么
7.3.36 SetterThatIgnoresPrototypeProperties ( thisValue, home, p, v )
抽象操作 SetterThatIgnoresPrototypeProperties 接受参数 thisValue（一个
- 如果 thisValue
不是对象 ，那么- 抛出
TypeError 异常。
- 抛出
- 如果
SameValue (thisValue, home) 是true ，那么 - 设 desc 为 ? thisValue.[[GetOwnProperty]](p)。
- 如果 desc 是
undefined ，那么- 执行 ?
CreateDataPropertyOrThrow (thisValue, p, v)。
- 执行 ?
- 否则，
- 执行 ?
Set (thisValue, p, v,true )。
- 执行 ?
- 返回
unused 。
7.4 迭代器对象上的操作
参见通用迭代接口（
7.4.1 迭代器记录
迭代器记录是一个next 方法。
迭代器记录具有
| 字段名称 | 值 | 含义 |
|---|---|---|
| [[Iterator]] | 一个对象 | 符合 |
| [[NextMethod]] | 一个 |
[[Iterator]] 对象的 next 方法。 |
| [[Done]] | 一个布尔值 |
7.4.2 GetIteratorDirect ( obj )
抽象操作 GetIteratorDirect 接受参数 obj（一个对象）并返回一个
7.4.3 GetIteratorFromMethod ( obj, method )
抽象操作 GetIteratorFromMethod 接受参数 obj（一个
- 设 iterator 为 ?
Call (method, obj)。 - 如果 iterator
不是对象 ，抛出TypeError 异常。 - 返回 ?
GetIteratorDirect (iterator)。
7.4.4 GetIterator ( obj, kind )
抽象操作 GetIterator 接受参数 obj（一个
- 如果 kind 是
async ，那么- 设 method 为 ?
GetMethod (obj,%Symbol.asyncIterator% )。 - 如果 method 是
undefined ，那么- 设 syncMethod 为 ?
GetMethod (obj,%Symbol.iterator% )。 - 如果 syncMethod 是
undefined ，抛出TypeError 异常。 - 设 syncIteratorRecord 为 ?
GetIteratorFromMethod (obj, syncMethod)。 - 返回
CreateAsyncFromSyncIterator (syncIteratorRecord)。
- 设 syncMethod 为 ?
- 设 method 为 ?
- 否则，
- 设 method 为 ?
GetMethod (obj,%Symbol.iterator% )。
- 设 method 为 ?
- 如果 method 是
undefined ，抛出TypeError 异常。 - 返回 ?
GetIteratorFromMethod (obj, method)。
7.4.5 GetIteratorFlattenable ( obj, primitiveHandling )
抽象操作 GetIteratorFlattenable 接受参数 obj（一个
- 如果 obj
不是对象 ，那么 - 设 method 为 ?
GetMethod (obj,%Symbol.iterator% )。 - 如果 method 是
undefined ，那么- 设 iterator 为 obj。
- 否则，
- 设 iterator 为 ?
Call (method, obj)。
- 设 iterator 为 ?
- 如果 iterator
不是对象 ，抛出TypeError 异常。 - 返回 ?
GetIteratorDirect (iterator)。
7.4.6 IteratorNext ( iteratorRecord [ , value ] )
抽象操作 IteratorNext 接受参数 iteratorRecord（一个
- 如果 value 不存在，那么
- 设 result 为
Completion (Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]]))。
- 设 result 为
- 否则，
- 设 result 为
Completion (Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « value »))。
- 设 result 为
- 如果 result 是
throw 完成 ，那么- 设 iteratorRecord.[[Done]] 为
true 。 - 返回 ? result。
- 设 iteratorRecord.[[Done]] 为
- 设 result 为 ! result。
- 如果 result
不是对象 ，那么- 设 iteratorRecord.[[Done]] 为
true 。 - 抛出
TypeError 异常。
- 设 iteratorRecord.[[Done]] 为
- 返回 result。
7.4.7 IteratorComplete ( iteratorResult )
抽象操作 IteratorComplete 接受参数 iteratorResult（一个对象）并返回一个
7.4.8 IteratorValue ( iteratorResult )
抽象操作 IteratorValue 接受参数 iteratorResult（一个对象）并返回一个
- 返回 ?
Get (iteratorResult,"value" )。
7.4.9 IteratorStep ( iteratorRecord )
抽象操作 IteratorStep 接受参数 iteratorRecord（一个
- 设 result 为 ?
IteratorNext (iteratorRecord)。 - 设 done 为
Completion (IteratorComplete (result))。 - 如果 done 是
throw 完成 ，那么- 设 iteratorRecord.[[Done]] 为
true 。 - 返回 ? done。
- 设 iteratorRecord.[[Done]] 为
- 设 done 为 ! done。
- 如果 done 是
true ，那么- 设 iteratorRecord.[[Done]] 为
true 。 - 返回
done 。
- 设 iteratorRecord.[[Done]] 为
- 返回 result。
7.4.10 IteratorStepValue ( iteratorRecord )
抽象操作 IteratorStepValue 接受参数 iteratorRecord（一个
- 设 result 为 ?
IteratorStep (iteratorRecord)。 - 如果 result 是
done ，那么- 返回
done 。
- 返回
- 设 value 为
Completion (IteratorValue (result))。 - 如果 value 是
throw 完成 ，那么- 设 iteratorRecord.[[Done]] 为
true 。
- 设 iteratorRecord.[[Done]] 为
- 返回 ? value。
7.4.11 IteratorClose ( iteratorRecord, completion )
抽象操作 IteratorClose 接受参数 iteratorRecord（一个
断言 ：iteratorRecord.[[Iterator]]是一个对象 。- 设 iterator 为 iteratorRecord.[[Iterator]]。
- 设 innerResult 为
Completion (GetMethod (iterator,"return" ))。 - 如果 innerResult 是
正常完成 ，那么- 设 return 为 innerResult.[[Value]]。
- 如果 return 是
undefined ，返回 ? completion。 - 设 innerResult 为
Completion (Call (return, iterator))。
- 如果 completion 是
throw 完成 ，返回 ? completion。 - 如果 innerResult 是
throw 完成 ，返回 ? innerResult。 - 如果 innerResult.[[Value]]
不是对象 ，抛出TypeError 异常。 - 返回 ? completion。
7.4.12 IfAbruptCloseIterator ( value, iteratorRecord )
IfAbruptCloseIterator 是使用
IfAbruptCloseIterator (value, iteratorRecord)。
与以下含义相同：
断言 ：value 是一个完成记录 。- 如果 value 是
异常完成 ，返回 ?IteratorClose (iteratorRecord, value)。 - 否则，设 value 为 ! value。
7.4.13 AsyncIteratorClose ( iteratorRecord, completion )
抽象操作 AsyncIteratorClose 接受参数 iteratorRecord（一个
断言 ：iteratorRecord.[[Iterator]]是一个对象 。- 设 iterator 为 iteratorRecord.[[Iterator]]。
- 设 innerResult 为
Completion (GetMethod (iterator,"return" ))。 - 如果 innerResult 是
正常完成 ，那么- 设 return 为 innerResult.[[Value]]。
- 如果 return 是
undefined ，返回 ? completion。 - 设 innerResult 为
Completion (Call (return, iterator))。 - 如果 innerResult 是
正常完成 ，设 innerResult 为Completion (Await (innerResult.[[Value]]))。
- 如果 completion 是
throw 完成 ，返回 ? completion。 - 如果 innerResult 是
throw 完成 ，返回 ? innerResult。 - 如果 innerResult.[[Value]]
不是对象 ，抛出TypeError 异常。 - 返回 ? completion。
7.4.14 CreateIteratorResultObject ( value, done )
抽象操作 CreateIteratorResultObject 接受参数 value（一个
- 设 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (obj,"value" , value)。 - 执行 !
CreateDataPropertyOrThrow (obj,"done" , done)。 - 返回 obj。
7.4.15 CreateListIteratorRecord ( list )
抽象操作 CreateListIteratorRecord 接受参数 list（一个包含
- 设 closure 为一个新的
抽象闭包 ，它没有参数，捕获 list，并在被调用时执行以下步骤：- 对于 list 的每个元素 E，执行
- 执行 ?
GeneratorYield (CreateIteratorResultObject (E,false ))。
- 执行 ?
- 返回
NormalCompletion (undefined )。
- 对于 list 的每个元素 E，执行
- 设 iterator 为
CreateIteratorFromClosure (closure,empty ,%Iterator.prototype% )。 - 返回
迭代器记录 { [[Iterator]]: iterator, [[NextMethod]]: %GeneratorPrototype.next%, [[Done]]:false }。
列表
7.4.16 IteratorToList ( iteratorRecord )
抽象操作 IteratorToList 接受参数 iteratorRecord（一个
- 设 values 为一个新的空
列表 。 - 重复，
- 设 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，那么- 返回 values。
- 将 next 追加到 values。
- 设 next 为 ?
8 语法定向操作
除了本节中定义的操作外，专用的
8.1 运行时语义：Evaluation
8.2 作用域分析
8.2.1 静态语义：BoundNames
它在以下产生式上分段定义：
- 返回一个
列表 ，其唯一元素是Identifier 的StringValue 。
- 返回 «
"yield" »。
- 返回 «
"await" »。
- 返回
BindingList 的BoundNames 。
- 设 names1 为
BindingList 的BoundNames 。 - 设 names2 为
LexicalBinding 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
BindingPattern 的BoundNames 。
- 设 names1 为
VariableDeclarationList 的BoundNames 。 - 设 names2 为
VariableDeclaration 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
BindingPattern 的BoundNames 。
- 返回一个新的空
列表 。
- 设 names1 为
BindingPropertyList 的BoundNames 。 - 设 names2 为
BindingRestProperty 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
列表 。
- 设 names1 为
BindingElementList 的BoundNames 。 - 设 names2 为
BindingRestElement 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 设 names1 为
BindingPropertyList 的BoundNames 。 - 设 names2 为
BindingProperty 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 设 names1 为
BindingElementList 的BoundNames 。 - 设 names2 为
BindingElisionElement 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
BindingElement 的BoundNames 。
- 返回
BindingElement 的BoundNames 。
- 返回
BindingPattern 的BoundNames 。
- 返回
ForBinding 的BoundNames 。
- 返回 «
"*default*" »。
- 返回一个新的空
列表 。
- 设 names1 为
FormalParameterList 的BoundNames 。 - 设 names2 为
FunctionRestParameter 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 设 names1 为
FormalParameterList 的BoundNames 。 - 设 names2 为
FormalParameter 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 设 formals 为被
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ArrowFormalParameters 。 - 返回 formals 的
BoundNames 。
- 返回 «
"*default*" »。
- 返回 «
"*default*" »。
- 返回 «
"*default*" »。
- 返回 «
"*default*" »。
- 设 head 为被
CoverCallExpressionAndAsyncArrowHead 覆盖 的AsyncArrowHead 。 - 返回 head 的
BoundNames 。
- 返回
ImportClause 的BoundNames 。
- 返回一个新的空
列表 。
- 设 names1 为
ImportedDefaultBinding 的BoundNames 。 - 设 names2 为
NameSpaceImport 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 设 names1 为
ImportedDefaultBinding 的BoundNames 。 - 设 names2 为
NamedImports 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
列表 。
- 设 names1 为
ImportsList 的BoundNames 。 - 设 names2 为
ImportSpecifier 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
列表 。
- 返回
Declaration 的BoundNames 。
- 设 declarationNames 为
HoistableDeclaration 的BoundNames 。 - 如果 declarationNames 不包含元素
"*default*" ，则将"*default*" 追加到 declarationNames。 - 返回 declarationNames。
- 设 declarationNames 为
ClassDeclaration 的BoundNames 。 - 如果 declarationNames 不包含元素
"*default*" ，则将"*default*" 追加到 declarationNames。 - 返回 declarationNames。
- 返回 «
"*default*" »。
8.2.2 静态语义：DeclarationPart
- 返回
ClassDeclaration 。
8.2.3 静态语义：IsConstantDeclaration
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
false 。
- 返回
false 。
没有必要将 export default
8.2.4 静态语义：词法声明的名称 (LexicallyDeclaredNames)
- 返回一个新的空
列表 。
- 令 names1 为
StatementList 的LexicallyDeclaredNames 。 - 令 names2 为
StatementListItem 的LexicallyDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 如果
Statement 是Statement : LabelledStatement LabelledStatement 的LexicallyDeclaredNames 。 - 返回一个新的空
列表 。
- 返回
Declaration 的BoundNames 。
- 返回一个新的空
列表 。
- 如果第一个
CaseClauses 存在，令 names1 为第一个CaseClauses 的LexicallyDeclaredNames 。 - 否则，令 names1 为一个新的空
列表 。 - 令 names2 为
DefaultClause 的LexicallyDeclaredNames 。 - 如果第二个
CaseClauses 存在，令 names3 为第二个CaseClauses 的LexicallyDeclaredNames 。 - 否则，令 names3 为一个新的空
列表 。 - 返回 names1、names2 和 names3 的
列表连接 。
- 令 names1 为
CaseClauses 的LexicallyDeclaredNames 。 - 令 names2 为
CaseClause 的LexicallyDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 如果
StatementList 存在，则返回StatementList 的LexicallyDeclaredNames 。 - 返回一个新的空
列表 。
- 如果
StatementList 存在，则返回StatementList 的LexicallyDeclaredNames 。 - 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
在
- 令 names1 为
ModuleItemList 的LexicallyDeclaredNames 。 - 令 names2 为
ModuleItem 的LexicallyDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
ImportDeclaration 的BoundNames 。
- 如果
ExportDeclaration 是exportVariableStatement ，则返回一个新的 空列表 。 - 返回
ExportDeclaration 的BoundNames 。
在
8.2.5 静态语义：词法作用域声明 (LexicallyScopedDeclarations)
- 令 declarations1 为
StatementList 的LexicallyScopedDeclarations 。 - 令 declarations2 为
StatementListItem 的LexicallyScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
- 如果
Statement 是Statement : LabelledStatement LabelledStatement 的LexicallyScopedDeclarations 。 - 返回一个新的空
列表 。
- 返回一个
列表 ，其唯一元素是Declaration 的DeclarationPart 。
- 返回一个新的空
列表 。
- 如果第一个
CaseClauses 存在，令 declarations1 为第一个CaseClauses 的LexicallyScopedDeclarations 。 - 否则，令 declarations1 为一个新的空
列表 。 - 令 declarations2 为
DefaultClause 的LexicallyScopedDeclarations 。 - 如果第二个
CaseClauses 存在，令 declarations3 为第二个CaseClauses 的LexicallyScopedDeclarations 。 - 否则，令 declarations3 为一个新的空
列表 。 - 返回 declarations1、declarations2 和 declarations3
的
列表连接 。
- 令 declarations1 为
CaseClauses 的LexicallyScopedDeclarations 。 - 令 declarations2 为
CaseClause 的LexicallyScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
- 如果
StatementList 存在，则返回StatementList 的LexicallyScopedDeclarations 。 - 返回一个新的空
列表 。
- 如果
StatementList 存在，则返回StatementList 的LexicallyScopedDeclarations 。 - 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回 «
FunctionDeclaration »。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 令 declarations1 为
ModuleItemList 的LexicallyScopedDeclarations 。 - 令 declarations2 为
ModuleItem 的LexicallyScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个
列表 ，其唯一元素是Declaration 的DeclarationPart 。
- 返回一个
列表 ，其唯一元素是HoistableDeclaration 的DeclarationPart 。
- 返回一个
列表 ，其唯一元素是ClassDeclaration 。
- 返回一个
列表 ，其唯一元素是这个ExportDeclaration 。
8.2.6 静态语义：VarDeclaredNames
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 令 names1 为
StatementList 的VarDeclaredNames 。 - 令 names2 为
StatementListItem 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
列表 。
- 令 names1 为第一个
Statement 的VarDeclaredNames 。 - 令 names2 为第二个
Statement 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
Statement 的VarDeclaredNames 。
- 返回
Statement 的VarDeclaredNames 。
- 返回
Statement 的VarDeclaredNames 。
- 返回
Statement 的VarDeclaredNames 。
- 令 names1 为
VariableDeclarationList 的BoundNames 。 - 令 names2 为
Statement 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
Statement 的VarDeclaredNames 。
- 返回
Statement 的VarDeclaredNames 。
- 令 names1 为
ForBinding 的BoundNames 。 - 令 names2 为
Statement 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
本节由附录
- 返回
Statement 的VarDeclaredNames 。
- 返回
CaseBlock 的VarDeclaredNames 。
- 返回一个新的空
列表 。
- 如果第一个
CaseClauses 存在，令 names1 为第一个CaseClauses 的VarDeclaredNames 。 - 否则，令 names1 为一个新的空
列表 。 - 令 names2 为
DefaultClause 的VarDeclaredNames 。 - 如果第二个
CaseClauses 存在，令 names3 为第二个CaseClauses 的VarDeclaredNames 。 - 否则，令 names3 为一个新的空
列表 。 - 返回 names1、names2 和 names3 的
列表连接 。
- 令 names1 为
CaseClauses 的VarDeclaredNames 。 - 令 names2 为
CaseClause 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 如果
StatementList 存在，则返回StatementList 的VarDeclaredNames 。 - 返回一个新的空
列表 。
- 如果
StatementList 存在，则返回StatementList 的VarDeclaredNames 。 - 返回一个新的空
列表 。
- 返回
LabelledItem 的VarDeclaredNames 。
- 返回一个新的空
列表 。
- 令 names1 为
Block 的VarDeclaredNames 。 - 令 names2 为
Catch 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 令 names1 为
Block 的VarDeclaredNames 。 - 令 names2 为
Finally 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 令 names1 为
Block 的VarDeclaredNames 。 - 令 names2 为
Catch 的VarDeclaredNames 。 - 令 names3 为
Finally 的VarDeclaredNames 。 - 返回 names1、names2 和 names3 的
列表连接 。
- 返回
Block 的VarDeclaredNames 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 令 names1 为
ModuleItemList 的VarDeclaredNames 。 - 令 names2 为
ModuleItem 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
列表 。
- 如果
ExportDeclaration 是exportVariableStatement ，则返回ExportDeclaration 的BoundNames 。 - 返回一个新的空
列表 。
8.2.7 静态语义：VarScopedDeclarations
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 令 declarations1 为
StatementList 的VarScopedDeclarations 。 - 令 declarations2 为
StatementListItem 的VarScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
- 返回一个新的空
列表 。
- 返回 «
VariableDeclaration »。
- 令 declarations1 为
VariableDeclarationList 的VarScopedDeclarations 。 - 返回 declarations1 和 «
VariableDeclaration » 的列表连接 。
- 令 declarations1 为第一个
Statement 的VarScopedDeclarations 。 - 令 declarations2 为第二个
Statement 的VarScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
- 令 declarations1 为
VariableDeclarationList 的VarScopedDeclarations 。 - 令 declarations2 为
Statement 的VarScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
- 令 declarations1 为 «
ForBinding »。 - 令 declarations2 为
Statement 的VarScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
本节由附录
- 返回一个新的空
列表 。
- 如果第一个
CaseClauses 存在，令 declarations1 为第一个CaseClauses 的VarScopedDeclarations 。 - 否则，令 declarations1 为一个新的空
列表 。 - 令 declarations2 为
DefaultClause 的VarScopedDeclarations 。 - 如果第二个
CaseClauses 存在，令 declarations3 为第二个CaseClauses 的VarScopedDeclarations 。 - 否则，令 declarations3 为一个新的空
列表 。 - 返回 declarations1、declarations2 和 declarations3 的
列表连接 。
- 令 declarations1 为
CaseClauses 的VarScopedDeclarations 。 - 令 declarations2 为
CaseClause 的VarScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
- 如果
StatementList 存在，返回StatementList 的VarScopedDeclarations 。 - 返回一个新的空
列表 。
- 如果
StatementList 存在，返回StatementList 的VarScopedDeclarations 。 - 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 令 declarations1 为
Block 的VarScopedDeclarations 。 - 令 declarations2 为
Catch 的VarScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
- 令 declarations1 为
Block 的VarScopedDeclarations 。 - 令 declarations2 为
Finally 的VarScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
- 令 declarations1 为
Block 的VarScopedDeclarations 。 - 令 declarations2 为
Catch 的VarScopedDeclarations 。 - 令 declarations3 为
Finally 的VarScopedDeclarations 。 - 返回 declarations1、declarations2 和 declarations3 的
列表连接 。
- 返回
Block 的VarScopedDeclarations 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 令 declarations1 为
ModuleItemList 的VarScopedDeclarations 。 - 令 declarations2 为
ModuleItem 的VarScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
- 返回一个新的空
列表 。
- 如果
ExportDeclaration 是exportVariableStatement ，返回VariableStatement 的VarScopedDeclarations 。 - 返回一个新的空
列表 。
8.2.8 静态语义：TopLevelLexicallyDeclaredNames
- 令 names1 为
StatementList 的TopLevelLexicallyDeclaredNames 。 - 令 names2 为
StatementListItem 的TopLevelLexicallyDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
列表 。
- 如果
Declaration 是Declaration : HoistableDeclaration - 返回一个新的空
列表 。
- 返回一个新的空
- 返回
Declaration 的BoundNames 。
在函数或脚本的顶层，函数声明被当作 var 声明处理，而不是词法声明。
8.2.9 静态语义：TopLevelLexicallyScopedDeclarations
- 令 declarations1 为
StatementList 的TopLevelLexicallyScopedDeclarations 。 - 令 declarations2 为
StatementListItem 的TopLevelLexicallyScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
- 返回一个新的空
列表 。
- 如果
Declaration 是Declaration : HoistableDeclaration - 返回一个新的空
列表 。
- 返回一个新的空
- 返回 «
Declaration »。
8.2.10 静态语义：TopLevelVarDeclaredNames
- 令 names1 为
StatementList 的TopLevelVarDeclaredNames 。 - 令 names2 为
StatementListItem 的TopLevelVarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 如果
Declaration 是Declaration : HoistableDeclaration - 返回一个新的空
列表 。
- 如果
Statement 是Statement : LabelledStatement Statement 的TopLevelVarDeclaredNames 。 - 返回
Statement 的VarDeclaredNames 。
在函数或脚本的顶层，内部函数声明被当作 var 声明处理。
- 如果
Statement 是Statement : LabelledStatement Statement 的TopLevelVarDeclaredNames 。 - 返回
Statement 的VarDeclaredNames 。
8.2.11 静态语义：TopLevelVarScopedDeclarations
- 令 declarations1 为
StatementList 的TopLevelVarScopedDeclarations 。 - 令 declarations2 为
StatementListItem 的TopLevelVarScopedDeclarations 。 - 返回 declarations1 和 declarations2 的
列表连接 。
- 如果
Statement 是Statement : LabelledStatement Statement 的TopLevelVarScopedDeclarations 。 - 返回
Statement 的VarScopedDeclarations 。
- 如果
Declaration 是Declaration : HoistableDeclaration - 令 declaration 为
HoistableDeclaration 的DeclarationPart 。 - 返回 « declaration »。
- 令 declaration 为
- 返回一个新的空
列表 。
- 如果
Statement 是Statement : LabelledStatement Statement 的TopLevelVarScopedDeclarations 。 - 返回
Statement 的VarScopedDeclarations 。
- 返回 «
FunctionDeclaration »。
8.3 标签
8.3.1 静态语义：ContainsDuplicateLabels
- 返回
false 。
- 令 hasDuplicates 为以参数 labelSet 调用
StatementList 的ContainsDuplicateLabels 。 - 如果 hasDuplicates 是
true ，返回true 。 - 返回以参数 labelSet 调用
StatementListItem 的ContainsDuplicateLabels 。
- 令 hasDuplicate 为以参数 labelSet 调用第一个
Statement 的ContainsDuplicateLabels 。 - 如果 hasDuplicate 是
true ，返回true 。 - 返回以参数 labelSet 调用第二个
Statement 的ContainsDuplicateLabels 。
- 返回以参数 labelSet 调用
Statement 的ContainsDuplicateLabels 。
- 返回以参数 labelSet 调用
Statement 的ContainsDuplicateLabels 。
- 返回以参数 labelSet 调用
Statement 的ContainsDuplicateLabels 。
- 返回以参数 labelSet 调用
Statement 的ContainsDuplicateLabels 。
- 返回以参数 labelSet 调用
Statement 的ContainsDuplicateLabels 。
此部分由附录
- 返回以参数 labelSet 调用
Statement 的ContainsDuplicateLabels 。
- 返回以参数 labelSet 调用
CaseBlock 的ContainsDuplicateLabels 。
- 返回
false 。
- 如果第一个
CaseClauses 存在，那么- 如果以参数 labelSet 调用第一个
CaseClauses 的ContainsDuplicateLabels 是true ，返回true 。
- 如果以参数 labelSet 调用第一个
- 如果以参数 labelSet 调用
DefaultClause 的ContainsDuplicateLabels 是true ，返回true 。 - 如果第二个
CaseClauses 不存在，返回false 。 - 返回以参数 labelSet 调用第二个
CaseClauses 的ContainsDuplicateLabels 。
- 令 hasDuplicates 为以参数 labelSet 调用
CaseClauses 的ContainsDuplicateLabels 。 - 如果 hasDuplicates 是
true ，返回true 。 - 返回以参数 labelSet 调用
CaseClause 的ContainsDuplicateLabels 。
- 如果
StatementList 存在，返回以参数 labelSet 调用StatementList 的ContainsDuplicateLabels 。 - 返回
false 。
- 如果
StatementList 存在，返回以参数 labelSet 调用StatementList 的ContainsDuplicateLabels 。 - 返回
false 。
- 令 label 为
LabelIdentifier 的StringValue 。 - 如果 labelSet 包含 label，返回
true 。 - 令 newLabelSet 为 labelSet 和 « label » 的
列表连接 。 - 返回以参数 newLabelSet 调用
LabelledItem 的ContainsDuplicateLabels 。
- 返回
false 。
- 令 hasDuplicates 为以参数 labelSet 调用
Block 的ContainsDuplicateLabels 。 - 如果 hasDuplicates 是
true ，返回true 。 - 返回以参数 labelSet 调用
Catch 的ContainsDuplicateLabels 。
- 令 hasDuplicates 为以参数 labelSet 调用
Block 的ContainsDuplicateLabels 。 - 如果 hasDuplicates 是
true ，返回true 。 - 返回以参数 labelSet 调用
Finally 的ContainsDuplicateLabels 。
- 如果以参数 labelSet 调用
Block 的ContainsDuplicateLabels 是true ，返回true 。 - 如果以参数 labelSet 调用
Catch 的ContainsDuplicateLabels 是true ，返回true 。 - 返回以参数 labelSet 调用
Finally 的ContainsDuplicateLabels 。
- 返回以参数 labelSet 调用
Block 的ContainsDuplicateLabels 。
- 返回
false 。
- 返回
false 。
- 令 hasDuplicates 为以参数 labelSet 调用
ModuleItemList 的ContainsDuplicateLabels 。 - 如果 hasDuplicates 是
true ，返回true 。 - 返回以参数 labelSet 调用
ModuleItem 的ContainsDuplicateLabels 。
- 返回
false 。
8.3.2 静态语义：ContainsUndefinedBreakTarget
- 返回
false 。
- 令 hasUndefinedLabels 为以参数 labelSet 调用
StatementList 的ContainsUndefinedBreakTarget 。 - 如果 hasUndefinedLabels 是
true ，返回true 。 - 返回以参数 labelSet 调用
StatementListItem 的ContainsUndefinedBreakTarget 。
- 令 hasUndefinedLabels 为以参数 labelSet 调用第一个
Statement 的ContainsUndefinedBreakTarget 。 - 如果 hasUndefinedLabels 是
true ，返回true 。 - 返回以参数 labelSet 调用第二个
Statement 的ContainsUndefinedBreakTarget 。
- 返回以参数 labelSet 调用
Statement 的ContainsUndefinedBreakTarget 。
- 返回以参数 labelSet 调用
Statement 的ContainsUndefinedBreakTarget 。
- 返回以参数 labelSet 调用
Statement 的ContainsUndefinedBreakTarget 。
- 返回以参数 labelSet 调用
Statement 的ContainsUndefinedBreakTarget 。
- 返回以参数 labelSet 调用
Statement 的ContainsUndefinedBreakTarget 。
本节由附录
- 返回
false 。
- 如果 labelSet 不包含
LabelIdentifier 的StringValue ，返回true 。 - 返回
false 。
- 返回以参数 labelSet 调用
Statement 的ContainsUndefinedBreakTarget 。
- 返回以参数 labelSet 调用
CaseBlock 的ContainsUndefinedBreakTarget 。
- 返回
false 。
- 如果第一个
CaseClauses 存在，那么- 如果以参数 labelSet 调用第一个
CaseClauses 的ContainsUndefinedBreakTarget 是true ，返回true 。
- 如果以参数 labelSet 调用第一个
- 如果以参数 labelSet 调用
DefaultClause 的ContainsUndefinedBreakTarget 是true ，返回true 。 - 如果第二个
CaseClauses 不存在，返回false 。 - 返回以参数 labelSet 调用第二个
CaseClauses 的ContainsUndefinedBreakTarget 。
- 令 hasUndefinedLabels 为以参数 labelSet 调用
CaseClauses 的ContainsUndefinedBreakTarget 。 - 如果 hasUndefinedLabels 是
true ，返回true 。 - 返回以参数 labelSet 调用
CaseClause 的ContainsUndefinedBreakTarget 。
- 如果
StatementList 存在，返回以参数 labelSet 调用StatementList 的ContainsUndefinedBreakTarget 。 - 返回
false 。
- 如果
StatementList 存在，返回以参数 labelSet 调用StatementList 的ContainsUndefinedBreakTarget 。 - 返回
false 。
- 令 label 为
LabelIdentifier 的StringValue 。 - 令 newLabelSet 为 labelSet 和 « label » 的
列表连接 。 - 返回以参数 newLabelSet 调用
LabelledItem 的ContainsUndefinedBreakTarget 。
- 返回
false 。
- 令 hasUndefinedLabels 为以参数 labelSet 调用
Block 的ContainsUndefinedBreakTarget 。 - 如果 hasUndefinedLabels 是
true ，返回true 。 - 返回以参数 labelSet 调用
Catch 的ContainsUndefinedBreakTarget 。
- 令 hasUndefinedLabels 为以参数 labelSet 调用
Block 的ContainsUndefinedBreakTarget 。 - 如果 hasUndefinedLabels 是
true ，返回true 。 - 返回以参数 labelSet 调用
Finally 的ContainsUndefinedBreakTarget 。
- 如果以参数 labelSet 调用
Block 的ContainsUndefinedBreakTarget 是true ，返回true 。 - 如果以参数 labelSet 调用
Catch 的ContainsUndefinedBreakTarget 是true ，返回true 。 - 返回以参数 labelSet 调用
Finally 的ContainsUndefinedBreakTarget 。
- 返回以参数 labelSet 调用
Block 的ContainsUndefinedBreakTarget 。
- 返回
false 。
- 返回
false 。
- 令 hasUndefinedLabels 为以参数 labelSet 调用
ModuleItemList 的ContainsUndefinedBreakTarget 。 - 如果 hasUndefinedLabels 是
true ，返回true 。 - 返回以参数 labelSet 调用
ModuleItem 的ContainsUndefinedBreakTarget 。
- 返回
false 。
8.3.3 静态语义：ContainsUndefinedContinueTarget
- 返回
false 。
- 返回以参数 iterationSet 和 « » 调用
BlockStatement 的ContainsUndefinedContinueTarget 。
- 令 newIterationSet 为 iterationSet 和 labelSet 的
列表连接 。 - 返回以参数 newIterationSet 和 « » 调用
IterationStatement 的ContainsUndefinedContinueTarget 。
- 令 hasUndefinedLabels 为以参数 iterationSet 和 « » 调用
StatementList 的ContainsUndefinedContinueTarget 。 - 如果 hasUndefinedLabels 是
true ，返回true 。 - 返回以参数 iterationSet 和 « » 调用
StatementListItem 的ContainsUndefinedContinueTarget 。
- 令 hasUndefinedLabels 为以参数 iterationSet 和 « » 调用第一个
Statement 的ContainsUndefinedContinueTarget 。 - 如果 hasUndefinedLabels 是
true ，返回true 。 - 返回以参数 iterationSet 和 « » 调用第二个
Statement 的ContainsUndefinedContinueTarget 。
- 返回以参数 iterationSet 和 « » 调用
Statement 的ContainsUndefinedContinueTarget 。
- 返回以参数 iterationSet 和 « » 调用
Statement 的ContainsUndefinedContinueTarget 。
- 返回以参数 iterationSet 和 « » 调用
Statement 的ContainsUndefinedContinueTarget 。
- 返回以参数 iterationSet 和 « » 调用
Statement 的ContainsUndefinedContinueTarget 。
- 返回以参数 iterationSet 和 « » 调用
Statement 的ContainsUndefinedContinueTarget 。
本节由附录
- 返回
false 。
- 如果 iterationSet 不包含
LabelIdentifier 的StringValue ，返回true 。 - 返回
false 。
- 返回以参数 iterationSet 和 « » 调用
Statement 的ContainsUndefinedContinueTarget 。
- 返回以参数 iterationSet 和 « » 调用
CaseBlock 的ContainsUndefinedContinueTarget 。
- 返回
false 。
- 如果第一个
CaseClauses 存在，那么- 如果以参数 iterationSet 和 « » 调用第一个
CaseClauses 的ContainsUndefinedContinueTarget 是true ，返回true 。
- 如果以参数 iterationSet 和 « » 调用第一个
- 如果以参数 iterationSet 和 « » 调用
DefaultClause 的ContainsUndefinedContinueTarget 是true ，返回true 。 - 如果第二个
CaseClauses 不存在，返回false 。 - 返回以参数 iterationSet 和 « » 调用第二个
CaseClauses 的ContainsUndefinedContinueTarget 。
- 令 hasUndefinedLabels 为以参数 iterationSet 和 « » 调用
CaseClauses 的ContainsUndefinedContinueTarget 。 - 如果 hasUndefinedLabels 是
true ，返回true 。 - 返回以参数 iterationSet 和 « » 调用
CaseClause 的ContainsUndefinedContinueTarget 。
- 如果
StatementList 存在，返回以参数 iterationSet 和 « » 调用StatementList 的ContainsUndefinedContinueTarget 。 - 返回
false 。
- 如果
StatementList 存在，返回以参数 iterationSet 和 « » 调用StatementList 的ContainsUndefinedContinueTarget 。 - 返回
false 。
- 令 label 为
LabelIdentifier 的StringValue 。 - 令 newLabelSet 为 labelSet 和 « label » 的
列表连接 。 - 返回以参数 iterationSet 和 newLabelSet 调用
LabelledItem 的ContainsUndefinedContinueTarget 。
- 返回
false 。
- 令 hasUndefinedLabels 为以参数 iterationSet 和 « » 调用
Block 的ContainsUndefinedContinueTarget 。 - 如果 hasUndefinedLabels 是
true ，返回true 。 - 返回以参数 iterationSet 和 « » 调用
Catch 的ContainsUndefinedContinueTarget 。
- 令 hasUndefinedLabels 为以参数 iterationSet 和 « » 调用
Block 的ContainsUndefinedContinueTarget 。 - 如果 hasUndefinedLabels 是
true ，返回true 。 - 返回以参数 iterationSet 和 « » 调用
Finally 的ContainsUndefinedContinueTarget 。
- 如果以参数 iterationSet 和 « » 调用
Block 的ContainsUndefinedContinueTarget 是true ，返回true 。 - 如果以参数 iterationSet 和 « » 调用
Catch 的ContainsUndefinedContinueTarget 是true ，返回true 。 - 返回以参数 iterationSet 和 « » 调用
Finally 的ContainsUndefinedContinueTarget 。
- 返回以参数 iterationSet 和 « » 调用
Block 的ContainsUndefinedContinueTarget 。
- 返回
false 。
- 返回
false 。
- 令 hasUndefinedLabels 为以参数 iterationSet 和 « » 调用
ModuleItemList 的ContainsUndefinedContinueTarget 。 - 如果 hasUndefinedLabels 是
true ，返回true 。 - 返回以参数 iterationSet 和 « » 调用
ModuleItem 的ContainsUndefinedContinueTarget 。
- 返回
false 。
8.4 函数名推断
8.4.1 静态语义：HasName
- 令 expr 为被
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ParenthesizedExpression 。 - 如果 expr 的
IsFunctionDefinition 是false ，返回false 。 - 返回 expr 的
HasName 。
- 返回
false 。
- 返回
true 。
8.4.2 静态语义：IsFunctionDefinition
- 令 expr 为被
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ParenthesizedExpression 。 - 返回 expr 的
IsFunctionDefinition 。
- 返回
false 。
- 返回
true 。
8.4.3 静态语义：IsAnonymousFunctionDefinition ( expr )
抽象操作 IsAnonymousFunctionDefinition 接受参数 expr（一个
- 如果 expr 的
IsFunctionDefinition 是false ，返回false 。 - 令 hasName 为 expr 的
HasName 。 - 如果 hasName 是
true ，返回false 。 - 返回
true 。
8.4.4 静态语义：IsIdentifierRef
- 返回
true 。
- 返回
false 。
8.4.5 运行时语义：NamedEvaluation
- 令 expr 为被
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ParenthesizedExpression 。 - 返回 ? expr 以参数 name 执行的
NamedEvaluation 。
断言 ：IsAnonymousFunctionDefinition (Expression ) 是true 。- 返回 ?
Expression 以参数 name 执行的NamedEvaluation 。
- 返回
FunctionExpression 以参数 name 执行的InstantiateOrdinaryFunctionExpression 。
- 返回
GeneratorExpression 以参数 name 执行的InstantiateGeneratorFunctionExpression 。
- 返回
AsyncGeneratorExpression 以参数 name 执行的InstantiateAsyncGeneratorFunctionExpression 。
- 返回
AsyncFunctionExpression 以参数 name 执行的InstantiateAsyncFunctionExpression 。
- 返回
ArrowFunction 以参数 name 执行的InstantiateArrowFunctionExpression 。
- 返回
AsyncArrowFunction 以参数 name 执行的InstantiateAsyncArrowFunctionExpression 。
- 令 value 为 ?
ClassTail 以参数undefined 和 name 执行的ClassDefinitionEvaluation 。 - 设置 value.[[SourceText]] 为
ClassExpression 匹配的源文本 。 - 返回 value。
8.5 包含 (Contains)
8.5.1 静态语义：包含 (Contains)
本规范中所有未在下面列出的语法产生式备选都隐式具有以下 包含 (Contains) 的默认定义：
- 返回
false 。
依赖于子结构的静态语义规则通常不深入函数定义。
依赖于子结构的静态语义规则通常不深入类体，除了
- 返回
false 。
依赖于子结构的静态语义规则通常不深入 static 初始化块。
- 令 formals 为被
覆盖带括号的表达式和箭头参数列表 覆盖 的箭头形式参数 。 - 返回 formals
包含 symbol。
- 如果 symbol 不是
NewTarget 、SuperProperty 、SuperCall 、super或this之一，返回false 。 - 返回
异步简洁体 包含 symbol。
- 如果 symbol 不是
NewTarget 、SuperProperty 、SuperCall 、super或this之一，返回false 。 - 令 head 为被
覆盖调用表达式和异步箭头头部 覆盖 的异步箭头头部 。 - 如果 head
包含 symbol 为true ，返回true 。 - 返回
异步简洁体 包含 symbol。
- 返回
false 。
- 如果 symbol 是
保留字 super，返回true 。 - 返回
false 。
- 返回
false 。
8.5.2 静态语义：计算属性包含 (ComputedPropertyContains)
- 返回
false 。
- 返回
false 。
- 返回
false 。
8.6 杂项
这些操作在规范中的多个地方使用。
8.6.1 运行时语义：InstantiateFunctionObject
- 返回
InstantiateOrdinaryFunctionObject ，其参数为FunctionDeclaration ，以及参数 env 和 privateEnv。
- 返回
InstantiateGeneratorFunctionObject ，其参数为GeneratorDeclaration ，以及参数 env 和 privateEnv。
- 返回
InstantiateAsyncGeneratorFunctionObject ，其参数为AsyncGeneratorDeclaration ，以及参数 env 和 privateEnv。
- 返回
InstantiateAsyncFunctionObject ，其参数为AsyncFunctionDeclaration ，以及参数 env 和 privateEnv。
8.6.2 运行时语义：BindingInitialization
它在以下产生式上分段定义：
- 令 name 为
Identifier 的StringValue 。 - 返回 ?
InitializeBoundName (name, value, environment).
- 返回 ?
InitializeBoundName ("yield" , value, environment).
- 返回 ?
InitializeBoundName ("await" , value, environment).
- 执行 ?
RequireObjectCoercible (value). - 返回 ?
BindingInitialization (ObjectBindingPattern with arguments value 和 environment.
- 令 iteratorRecord 为 ?
GetIterator (value,sync ). - 令 result 为
Completion (IteratorBindingInitialization ofArrayBindingPattern with arguments iteratorRecord 和 environment). - 如果 iteratorRecord.[[Done]] 为
false ，则返回 ?IteratorClose (iteratorRecord, result). - 返回 ? result.
- 返回
unused .
- 执行 ?
PropertyBindingInitialization (BindingPropertyList with arguments value 和 environment. - 返回
unused .
- 令 excludedNames 为一个新的空
列表 。 - 返回 ?
RestBindingInitialization (BindingRestProperty with arguments value, environment, 和 excludedNames.
- 令 excludedNames 为 ?
PropertyBindingInitialization (BindingPropertyList with arguments value 和 environment. - 返回 ?
RestBindingInitialization (BindingRestProperty with arguments value, environment, 和 excludedNames.
8.6.2.1 InitializeBoundName ( name, value, environment )
抽象操作 InitializeBoundName 接受参数 name（一个字符串）、value（一个
- 如果 environment 不是
undefined ，则：- 执行 ! environment.InitializeBinding(name, value).
- 返回
unused .
- 否则：
- 令 lhs 为 ?
ResolveBinding (name). - 返回 ?
PutValue (lhs, value).
- 令 lhs 为 ?
8.6.3 运行时语义：IteratorBindingInitialization
它在以下产生式上分段定义：
- 返回
unused 。
- 返回 ?
IteratorDestructuringAssignmentEvaluation ofElision with argument iteratorRecord。
- 如果
Elision 存在，则- 执行 ?
IteratorDestructuringAssignmentEvaluation ofElision with argument iteratorRecord。
- 执行 ?
- 返回 ?
IteratorBindingInitialization ofBindingRestElement with arguments iteratorRecord and environment。
- 执行 ?
IteratorBindingInitialization ofBindingElementList with arguments iteratorRecord and environment。 - 返回 ?
IteratorDestructuringAssignmentEvaluation ofElision with argument iteratorRecord。
- 执行 ?
IteratorBindingInitialization ofBindingElementList with arguments iteratorRecord and environment。 - 如果
Elision 存在，则- 执行 ?
IteratorDestructuringAssignmentEvaluation ofElision with argument iteratorRecord。
- 执行 ?
- 返回 ?
IteratorBindingInitialization ofBindingRestElement with arguments iteratorRecord and environment。
- 执行 ?
IteratorBindingInitialization ofBindingElementList with arguments iteratorRecord and environment。 - 返回 ?
IteratorBindingInitialization ofBindingElisionElement with arguments iteratorRecord and environment。
- 执行 ?
IteratorDestructuringAssignmentEvaluation ofElision with argument iteratorRecord。 - 返回 ?
IteratorBindingInitialization ofBindingElement with arguments iteratorRecord and environment。
- 设 bindingId 为
BindingIdentifier 的StringValue 。 - 设 lhs 为 ?
ResolveBinding (bindingId, environment)。 - 设 v 为
undefined 。 - 如果 iteratorRecord.[[Done]] 是
false ，则- 设 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 设置 v 为 next。
- 设 next 为 ?
- 如果
Initializer 存在且 v 是undefined ，则- 如果
IsAnonymousFunctionDefinition (Initializer ) 是true ，则- 设置 v 为 ?
NamedEvaluation ofInitializer with argument bindingId。
- 设置 v 为 ?
- 否则，
- 设 defaultValue 为 ?
Evaluation ofInitializer 。 - 设置 v 为 ?
GetValue (defaultValue)。
- 设 defaultValue 为 ?
- 如果
- 如果 environment 是
undefined ，则返回 ?PutValue (lhs, v)。 - 返回 ?
InitializeReferencedBinding (lhs, v)。
- 设 v 为
undefined 。 - 如果 iteratorRecord.[[Done]] 是
false ，则- 设 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 设置 v 为 next。
- 设 next 为 ?
- 如果
Initializer 存在且 v 是undefined ，则- 设 defaultValue 为 ?
Evaluation ofInitializer 。 - 设置 v 为 ?
GetValue (defaultValue)。
- 设 defaultValue 为 ?
- 返回 ?
BindingInitialization ofBindingPattern with arguments v and environment。
- 设 lhs 为 ?
ResolveBinding (BindingIdentifier 的StringValue , environment)。 - 设 A 为 !
ArrayCreate (0)。 - 设 n 为 0。
- 重复，
- 设 next 为
done 。 - 如果 iteratorRecord.[[Done]] 是
false ，则- 设置 next 为 ?
IteratorStepValue (iteratorRecord)。
- 设置 next 为 ?
- 如果 next 是
done ，则- 如果 environment 是
undefined ，则返回 ?PutValue (lhs, A)。 - 返回 ?
InitializeReferencedBinding (lhs, A)。
- 如果 environment 是
- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), next)。 - 设置 n 为 n + 1。
- 设 next 为
- 设 A 为 !
ArrayCreate (0)。 - 设 n 为 0。
- 重复，
- 设 next 为
done 。 - 如果 iteratorRecord.[[Done]] 是
false ，则- 设置 next 为 ?
IteratorStepValue (iteratorRecord)。
- 设置 next 为 ?
- 如果 next 是
done ，则- 返回 ?
BindingInitialization ofBindingPattern with arguments A and environment。
- 返回 ?
- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), next)。 - 设置 n 为 n + 1。
- 设 next 为
- 返回
unused 。
- 执行 ?
IteratorBindingInitialization ofFormalParameterList with arguments iteratorRecord and environment。 - 返回 ?
IteratorBindingInitialization ofFunctionRestParameter with arguments iteratorRecord and environment。
- 执行 ?
IteratorBindingInitialization ofFormalParameterList with arguments iteratorRecord and environment。 - 返回 ?
IteratorBindingInitialization ofFormalParameter with arguments iteratorRecord and environment。
- 设 v 为
undefined 。 断言 ： iteratorRecord.[[Done]] 是false 。- 设 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 设置 v 为 next。
- 返回 ?
BindingInitialization ofBindingIdentifier with arguments v and environment。
- 设 formals 为被
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ArrowFormalParameters 。 - 返回 ?
IteratorBindingInitialization of formals with arguments iteratorRecord and environment。
- 设 v 为
undefined 。 断言 ： iteratorRecord.[[Done]] 是false 。- 设 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 设置 v 为 next。
- 返回 ?
BindingInitialization ofBindingIdentifier with arguments v and environment。
8.6.4 静态语义：AssignmentTargetType
- 如果
IsStrict (thisIdentifierReference ) 是true 且Identifier 的StringValue 是"eval" 或"arguments" ，返回invalid 。 - 返回
simple 。
- 返回
simple 。
- 设 expr 为被
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ParenthesizedExpression 。 - 返回 expr 的
AssignmentTargetType 。
- 返回
invalid 。
8.6.5 静态语义：PropName
- 返回
empty 。
- 返回
PropertyName 的PropName 。
- 返回
IdentifierName 的StringValue 。
- 返回
StringLiteral 的SV 。
- 设 nbr 为
NumericLiteral 的NumericValue 。 - 返回 !
ToString (nbr)。
- 返回
empty 。
- 返回
ClassElementName 的PropName 。
- 返回
ClassElementName 的PropName 。
- 返回
ClassElementName 的PropName 。
- 返回
empty 。
- 返回
empty 。
- 返回
ClassElementName 的PropName 。
- 返回
ClassElementName 的PropName 。
- 返回
empty 。
9 可执行代码和执行上下文
9.1 环境记录
环境记录是一种规范类型，
用于定义
每个环境记录都有一个[[OuterEnv]]字段，它要么是
环境记录纯粹是规范机制，不需要对应于ECMAScript实现的任何特定构件。 ECMAScript程序不可能直接访问或操作这样的值。
9.1.1 环境记录类型层次结构
-
环境记录 （抽象）
| 方法 | 目的 |
|---|---|
| HasBinding(N) |
确定 |
| CreateMutableBinding(N, D) |
在 |
| CreateImmutableBinding(N, S) |
在 |
| InitializeBinding(N, V) |
设置 |
| SetMutableBinding(N, V, S) |
设置 |
| GetBindingValue(N, S) |
从 |
| DeleteBinding(N) |
从 |
| HasThisBinding() |
确定this绑定。如果建立则返回 |
| HasSuperBinding() |
确定super方法绑定。如果建立则返回
|
| WithBaseObject() |
如果此with语句关联，则返回with对象。
否则，返回 |
9.1.1.1 声明式环境记录
每个声明式环境记录都与包含变量、常量、let、类、模块、导入和/或函数声明的ECMAScript程序作用域相关联。声明式环境记录绑定其作用域内包含的声明所定义的标识符集合。
9.1.1.1.1 HasBinding ( N )
- 如果envRec具有N的绑定，返回
true 。 - 返回
false 。
9.1.1.1.2 CreateMutableBinding ( N, D )
断言 ： envRec不已经具有N的绑定。- 在envRec中为N创建可变绑定并记录它是未初始化的。如果D是
true ，记录新创建的绑定可以被后续的DeleteBinding调用删除。 - 返回
unused 。
9.1.1.1.3 CreateImmutableBinding ( N, S )
断言 ： envRec不已经具有N的绑定。- 在envRec中为N创建不可变绑定并记录它是未初始化的。如果S是
true ，记录新创建的绑定是严格绑定。 - 返回
unused 。
9.1.1.1.4 InitializeBinding ( N, V )
断言 ： envRec必须具有N的未初始化绑定。- 将envRec中N的绑定值设置为V。
记录 envRec中N的绑定已被初始化。- 返回
unused 。
9.1.1.1.5 SetMutableBinding ( N, V, S )
-
如果envRec没有N的绑定，则
- 如果S是
true ，抛出ReferenceError 异常。 - 执行! envRec.CreateMutableBinding(N,
true )。 - 执行! envRec.InitializeBinding(N, V)。
- 返回
unused 。
- 如果S是
- 如果envRec中N的绑定是严格绑定，将S设置为
true 。 - 如果envRec中N的绑定尚未初始化，则
- 抛出
ReferenceError 异常。
- 抛出
- 否则如果envRec中N的绑定是可变绑定，则
- 将其绑定值更改为V。
- 否则，
断言 ：这是尝试更改不可变绑定的值。- 如果S是
true ，抛出TypeError 异常。
- 返回
unused 。
导致步骤
function f() { eval("var x; x = (delete x, 0);"); }9.1.1.1.6 GetBindingValue ( N, S )
断言 ： envRec具有N的绑定。- 如果envRec中N的绑定是未初始化绑定，抛出
ReferenceError 异常。 - 返回envRec中当前绑定到N的值。
9.1.1.1.7 DeleteBinding ( N )
断言 ： envRec具有N的绑定。- 如果envRec中N的绑定无法删除，返回
false 。 - 从envRec中移除N的绑定。
- 返回
true 。
9.1.1.1.8 HasThisBinding ( )
- 返回
false 。
9.1.1.1.9 HasSuperBinding ( )
- 返回
false 。
9.1.1.1.10 WithBaseObject ( )
- 返回
undefined 。
9.1.1.2 对象环境记录
每个对象环境记录
都与一个称为其绑定对象的对象相关联。对象环境记录绑定一组字符串标识符名称，
这些名称直接对应于其绑定对象的属性名称。不是
为with语句（
对象环境记录具有
9.1.1.2.1 HasBinding ( N )
- 设bindingObject为envRec.[[BindingObject]]。
- 设foundBinding为?
HasProperty (bindingObject, N)。 - 如果foundBinding是
false ，返回false 。 - 如果envRec.[[IsWithEnvironment]]是
false ，返回true 。 - 设unscopables为?
Get (bindingObject,%Symbol.unscopables% )。 - 如果unscopables
是对象 ，则 - 返回
true 。
9.1.1.2.2 CreateMutableBinding ( N, D )
- 设bindingObject为envRec.[[BindingObject]]。
- 执行?
DefinePropertyOrThrow (bindingObject, N, PropertyDescriptor { [[Value]]:undefined , [[Writable]]:true , [[Enumerable]]:true , [[Configurable]]: D })。 - 返回
unused 。
通常envRec不会有N的绑定，但如果有，
9.1.1.2.3 CreateImmutableBinding ( N, S )
9.1.1.2.4 InitializeBinding ( N, V )
- 执行? envRec.SetMutableBinding(N,
V,
false )。 - 返回
unused 。
9.1.1.2.5 SetMutableBinding ( N, V, S )
- 设bindingObject为envRec.[[BindingObject]]。
- 设stillExists为?
HasProperty (bindingObject, N)。 - 如果stillExists是
false 且S是true ，抛出ReferenceError 异常。 - 执行?
Set (bindingObject, N, V, S)。 - 返回
unused 。
9.1.1.2.6 GetBindingValue ( N, S )
- 设bindingObject为envRec.[[BindingObject]]。
- 设value为?
HasProperty (bindingObject, N)。 - 如果value是
false ，则- 如果S是
false ，返回undefined ；否则抛出ReferenceError 异常。
- 如果S是
- 返回?
Get (bindingObject, N)。
9.1.1.2.7 DeleteBinding ( N )
- 设bindingObject为envRec.[[BindingObject]]。
- 返回? bindingObject.[[Delete]](N)。
9.1.1.2.8 HasThisBinding ( )
- 返回
false 。
this绑定。
9.1.1.2.9 HasSuperBinding ( )
- 返回
false 。
super绑定。
9.1.1.2.10 WithBaseObject ( )
- 如果envRec.[[IsWithEnvironment]]是
true ，返回envRec.[[BindingObject]]。 - 否则，返回
undefined 。
9.1.1.3 函数环境记录
函数环境记录是一个this绑定。如果函数不是super，其函数环境记录还包含用于在函数内执行super方法调用的状态。
函数环境记录具有
| 字段名称 | 值 | 含义 |
|---|---|---|
| [[ThisValue]] |
一个 |
这是用于此函数调用的 |
| [[ThisBindingStatus]] |
|
如果值是 |
| [[FunctionObject]] |
一个ECMAScript |
调用导致创建此 |
| [[NewTarget]] |
一个 |
如果此 |
函数环境记录支持
9.1.1.3.1 BindThisValue ( envRec, V )
抽象操作BindThisValue接受参数envRec（一个
断言 ： envRec.[[ThisBindingStatus]]不是lexical 。- 如果envRec.[[ThisBindingStatus]]是
initialized ，抛出ReferenceError 异常。 - 设置envRec.[[ThisValue]]为V。
- 设置envRec.[[ThisBindingStatus]]为
initialized 。 - 返回
unused 。
9.1.1.3.2 HasThisBinding ( )
- 如果envRec.[[ThisBindingStatus]]是
lexical ，返回false ；否则，返回true 。
9.1.1.3.3 HasSuperBinding ( )
- 如果envRec.[[ThisBindingStatus]]是
lexical ，返回false 。 - 如果envRec.[[FunctionObject]].[[HomeObject]]是
undefined ，返回false ；否则，返回true 。
9.1.1.3.4 GetThisBinding ( )
断言 ： envRec.[[ThisBindingStatus]]不是lexical 。- 如果envRec.[[ThisBindingStatus]]是
uninitialized ，抛出ReferenceError 异常。 - 返回envRec.[[ThisValue]]。
9.1.1.3.5 GetSuperBase ( envRec )
抽象操作GetSuperBase接受参数envRec（一个super属性访问基础的对象。值
9.1.1.4 全局环境记录
全局环境记录用于表示被在共同
全局环境记录在逻辑上是单个记录，但它被指定为一个封装
属性可以直接在
全局环境记录具有
9.1.1.4.1 HasBinding ( N )
- 设DclRec为envRec.[[DeclarativeRecord]]。
- 如果! DclRec.HasBinding(N)是
true ， 返回true 。 - 设ObjRec为envRec.[[ObjectRecord]]。
- 返回? ObjRec.HasBinding(N)。
9.1.1.4.2 CreateMutableBinding ( N, D )
- 设DclRec为envRec.[[DeclarativeRecord]]。
- 如果! DclRec.HasBinding(N)是
true ， 抛出TypeError 异常。 - 返回! DclRec.CreateMutableBinding(N, D)。
9.1.1.4.3 CreateImmutableBinding ( N, S )
- 设DclRec为envRec.[[DeclarativeRecord]]。
- 如果! DclRec.HasBinding(N)是
true ， 抛出TypeError 异常。 - 返回! DclRec.CreateImmutableBinding(N, S)。
9.1.1.4.4 InitializeBinding ( N, V )
9.1.1.4.5 SetMutableBinding ( N, V, S )
- 设DclRec为envRec.[[DeclarativeRecord]]。
- 如果! DclRec.HasBinding(N)是
true ， 则- 返回? DclRec.SetMutableBinding(N, V, S)。
- 设ObjRec为envRec.[[ObjectRecord]]。
- 返回? ObjRec.SetMutableBinding(N, V, S)。
9.1.1.4.6 GetBindingValue ( N, S )
- 设DclRec为envRec.[[DeclarativeRecord]]。
- 如果! DclRec.HasBinding(N)是
true ， 则- 返回? DclRec.GetBindingValue(N, S)。
- 设ObjRec为envRec.[[ObjectRecord]]。
- 返回? ObjRec.GetBindingValue(N, S)。
9.1.1.4.7 DeleteBinding ( N )
- 设DclRec为envRec.[[DeclarativeRecord]]。
- 如果! DclRec.HasBinding(N)是
true ， 则- 返回! DclRec.DeleteBinding(N)。
- 设ObjRec为envRec.[[ObjectRecord]]。
- 设globalObject为ObjRec.[[BindingObject]]。
- 设existingProp为?
HasOwnProperty (globalObject, N)。 - 如果existingProp是
true ，则- 返回? ObjRec.DeleteBinding(N)。
- 返回
true 。
9.1.1.4.8 HasThisBinding ( )
- 返回
true 。
this绑定。
9.1.1.4.9 HasSuperBinding ( )
- 返回
false 。
super绑定。
9.1.1.4.10 WithBaseObject ( )
- 返回
undefined 。
9.1.1.4.11 GetThisBinding ( )
- 返回envRec.[[GlobalThisValue]]。
9.1.1.4.12 HasLexicalDeclaration ( envRec, N )
抽象操作HasLexicalDeclaration接受参数envRec（一个
- 设DclRec为envRec.[[DeclarativeRecord]]。
- 返回! DclRec.HasBinding(N)。
9.1.1.4.13 HasRestrictedGlobalProperty ( envRec, N )
抽象操作HasRestrictedGlobalProperty接受参数envRec（一个
- 设ObjRec为envRec.[[ObjectRecord]]。
- 设globalObject为ObjRec.[[BindingObject]]。
- 设existingProp为? globalObject.[[GetOwnProperty]](N)。
- 如果existingProp是
undefined ，返回false 。 - 如果existingProp.[[Configurable]]是
true ，返回false 。 - 返回
true 。
9.1.1.4.14 CanDeclareGlobalVar ( envRec, N )
抽象操作CanDeclareGlobalVar接受参数envRec（一个
- 设ObjRec为envRec.[[ObjectRecord]]。
- 设globalObject为ObjRec.[[BindingObject]]。
- 设hasProperty为?
HasOwnProperty (globalObject, N)。 - 如果hasProperty是
true ，返回true 。 - 返回?
IsExtensible (globalObject)。
9.1.1.4.15 CanDeclareGlobalFunction ( envRec, N )
抽象操作CanDeclareGlobalFunction接受参数envRec（一个
- 设ObjRec为envRec.[[ObjectRecord]]。
- 设globalObject为ObjRec.[[BindingObject]]。
- 设existingProp为? globalObject.[[GetOwnProperty]](N)。
- 如果existingProp是
undefined ，返回?IsExtensible (globalObject)。 - 如果existingProp.[[Configurable]]是
true ，返回true 。 - 如果
IsDataDescriptor (existingProp) 是true 且existingProp有属性值{ [[Writable]]:true , [[Enumerable]]:true }，返回true 。 - 返回
false 。
9.1.1.4.16 CreateGlobalVarBinding ( envRec, N, D )
抽象操作CreateGlobalVarBinding接受参数envRec（一个
- 设ObjRec为envRec.[[ObjectRecord]]。
- 设globalObject为ObjRec.[[BindingObject]]。
- 设hasProperty为?
HasOwnProperty (globalObject, N)。 - 设extensible为?
IsExtensible (globalObject)。 - 如果hasProperty是
false 且extensible是true ，则- 执行? ObjRec.CreateMutableBinding(N, D)。
- 执行? ObjRec.InitializeBinding(N,
undefined )。
- 返回
unused 。
9.1.1.4.17 CreateGlobalFunctionBinding ( envRec, N, V, D )
抽象操作CreateGlobalFunctionBinding接受参数envRec（一个
- 设ObjRec为envRec.[[ObjectRecord]]。
- 设globalObject为ObjRec.[[BindingObject]]。
- 设existingProp为? globalObject.[[GetOwnProperty]](N)。
- 如果existingProp是
undefined 或existingProp.[[Configurable]]是true ，则- 设desc为属性描述符{ [[Value]]:
V, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]: D }。
- 设desc为属性描述符{ [[Value]]:
V, [[Writable]]:
- 否则，
- 设desc为属性描述符{ [[Value]]: V }。
- 执行?
DefinePropertyOrThrow (globalObject, N, desc)。 - 执行?
Set (globalObject, N, V,false )。 - 返回
unused 。
9.1.1.5 模块环境记录
模块环境记录是一个
模块环境记录支持
9.1.1.5.1 GetBindingValue ( N, S )
9.1.1.5.2 DeleteBinding ( N )
9.1.1.5.3 HasThisBinding ( )
- 返回
true 。
this 绑定。
9.1.1.5.4 GetThisBinding ( )
- 返回
undefined 。
9.1.1.5.5 CreateImportBinding ( envRec, N, M, N2 )
抽象操作 CreateImportBinding 接收参数 envRec（一个
9.1.2 环境记录操作
9.1.2.1 GetIdentifierReference ( env, name, strict )
抽象操作 GetIdentifierReference 接收参数 env（一个
- 如果 env 是
null ，那么- 返回
引用记录 { [[Base]]:unresolvable , [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]:empty }。
- 返回
- 设 exists 为 ? env.HasBinding(name)。
- 如果 exists 是
true ，那么- 返回
引用记录 { [[Base]]: env, [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]:empty }。
- 返回
- 否则，
- 设 outer 为 env.[[OuterEnv]]。
- 返回 ?
GetIdentifierReference (outer, name, strict)。
9.1.2.2 NewDeclarativeEnvironment ( E )
抽象操作 NewDeclarativeEnvironment 接收参数 E（一个
- 设 env 为一个不包含绑定的新
声明式环境记录 。 - 设置 env.[[OuterEnv]] 为 E。
- 返回 env。
9.1.2.3 NewObjectEnvironment ( O, W, E )
抽象操作 NewObjectEnvironment 接收参数 O（一个对象）、W（一个布尔值）和
E（一个
- 设 env 为一个新的
对象环境记录 。 - 设置 env.[[BindingObject]] 为 O。
- 设置 env.[[IsWithEnvironment]] 为 W。
- 设置 env.[[OuterEnv]] 为 E。
- 返回 env。
9.1.2.4 NewFunctionEnvironment ( F, newTarget )
抽象操作 NewFunctionEnvironment 接收参数 F（一个 ECMAScript
- 设 env 为一个不包含绑定的新
函数环境记录 。 - 设置 env.[[FunctionObject]] 为 F。
- 如果 F.[[ThisMode]] 是
lexical ，设置 env.[[ThisBindingStatus]] 为lexical 。 - 否则，设置 env.[[ThisBindingStatus]] 为
uninitialized 。 - 设置 env.[[NewTarget]] 为 newTarget。
- 设置 env.[[OuterEnv]] 为 F.[[Environment]]。
- 返回 env。
9.1.2.5 NewGlobalEnvironment ( G, thisValue )
抽象操作 NewGlobalEnvironment 接收参数 G（一个对象）和 thisValue（一个对象），并返回一个
- 设 objRec 为
NewObjectEnvironment (G,false ,null )。 - 设 dclRec 为
NewDeclarativeEnvironment (null )。 - 设 env 为一个新的
全局环境记录 。 - 设置 env.[[ObjectRecord]] 为 objRec。
- 设置 env.[[GlobalThisValue]] 为 thisValue。
- 设置 env.[[DeclarativeRecord]] 为 dclRec。
- 设置 env.[[OuterEnv]] 为
null 。 - 返回 env。
9.1.2.6 NewModuleEnvironment ( E )
抽象操作 NewModuleEnvironment 接收参数 E（一个
- 设 env 为一个不包含绑定的新
模块环境记录 。 - 设置 env.[[OuterEnv]] 为 E。
- 返回 env。
9.2 私有环境记录
私有环境记录是一种规范机制，用于基于 ECMAScript 代码中
9.2.1 私有环境记录操作
9.2.1.1 NewPrivateEnvironment ( outerPrivateEnv )
抽象操作 NewPrivateEnvironment 接收参数 outerPrivateEnv（一个
9.2.1.2 ResolvePrivateIdentifier ( privateEnv, identifier )
抽象操作 ResolvePrivateIdentifier 接收参数 privateEnv（一个
- 设 names 为 privateEnv.[[Names]]。
- 对于 names 的每个
私有名称 pn，执行- 如果 pn.[[Description]] 是
identifier，那么
- 返回 pn。
- 如果 pn.[[Description]] 是
identifier，那么
- 设 outerPrivateEnv 为 privateEnv.[[OuterPrivateEnvironment]]。
断言 ： outerPrivateEnv 不是null 。- 返回
ResolvePrivateIdentifier (outerPrivateEnv, identifier)。
9.3 领域
在求值之前，所有 ECMAScript 代码都必须与一个领域关联。从概念上讲，一个
| 字段名称 | 值 | 含义 |
|---|---|---|
| [[AgentSignifier]] |
一个 |
拥有此 |
| [[Intrinsics]] |
一个 |
与此 |
| [[GlobalObject]] | 一个对象 |
此 |
| [[GlobalEnv]] |
一个 |
此 |
| [[TemplateMap]] |
具有字段 [[Site]]（一个 |
模板对象使用其 一旦
|
| [[LoadedModules]] |
|
从此
如
import() 表达式时使用。
|
| [[HostDefined]] |
任何值（默认值为 |
为需要将附加信息与 |
9.3.1 InitializeHostDefinedRealm ( )
抽象操作 InitializeHostDefinedRealm 不接收参数，并返回
- 设 realm 为一个新的
领域记录 。 - 执行
CreateIntrinsics (realm)。 - 设置 realm.[[AgentSignifier]] 为
AgentSignifier ()。 - 设置 realm.[[TemplateMap]] 为一个新的空
列表 。 - 设 newContext 为一个新的
执行上下文 。 - 设置 newContext 的 Function 为
null 。 - 设置 newContext 的
领域 为 realm。 - 设置 newContext 的 ScriptOrModule 为
null 。 - 将 newContext 推入
执行上下文栈 ；newContext 现在是运行执行上下文 。 - 如果
宿主 要求使用异质对象 作为 realm 的全局对象 ，那么- 设 global 为以
宿主定义 的方式创建的这样一个对象。
- 设 global 为以
- 否则，
- 设 global 为
OrdinaryObjectCreate (realm.[[Intrinsics]].[[%Object.prototype% ]])。
- 设 global 为
- 如果
宿主 要求 realm 的全局作用域中的this绑定返回除全局对象 之外的对象，那么- 设 thisValue 为以
宿主定义 的方式创建的这样一个对象。
- 设 thisValue 为以
- 否则，
- 设 thisValue 为 global。
- 设置 realm.[[GlobalObject]] 为 global。
- 设置 realm.[[GlobalEnv]] 为
NewGlobalEnvironment (global, thisValue)。 - 执行 ?
SetDefaultGlobalBindings (realm)。 - 在 global 上创建任何
宿主定义 的全局对象 属性。 - 返回
unused 。
9.3.2 CreateIntrinsics ( realmRec )
抽象操作 CreateIntrinsics 接收参数 realmRec（一个
- 设置 realmRec.[[Intrinsics]] 为一个新的
记录 。 - 使用
表 6 中列出的值设置 realmRec.[[Intrinsics]] 的字段。字段名称是表第一列中列出的名称。每个字段的值是一个新的对象值，完全且递归地填充了属性值，如子句19 到28 中每个对象的规范所定义。所有对象属性值都是新创建的对象值。所有作为内建函数对象 的值都通过执行CreateBuiltinFunction (steps, length, name, slots, realmRec, prototype) 创建，其中 steps 是本规范提供的该函数的定义，name 是函数"name" 属性的初始值，length 是函数"length" 属性的初始值，slots 是函数指定的内部插槽名称的列表（如果有），prototype 是函数 [[Prototype]] 内部插槽的指定值。内建对象及其属性的创建必须有序，以避免依赖尚未创建的对象。 - 执行
AddRestrictedFunctionProperties (realmRec.[[Intrinsics]].[[%Function.prototype% ]], realmRec)。 - 返回
unused 。
9.3.3 SetDefaultGlobalBindings ( realmRec )
抽象操作 SetDefaultGlobalBindings 接收参数 realmRec（一个
9.4 执行上下文
执行上下文是一种规范设备，用于跟踪 ECMAScript
实现对代码的运行时求值。在任何时候，每个
执行上下文栈用于跟踪执行上下文。
执行上下文包含跟踪其关联代码的执行进度所需的任何实现特定状态。每个执行上下文至少具有
ECMAScript 代码执行上下文具有
执行上下文的 LexicalEnvironment 和 VariableEnvironment 组件始终是
表示生成器求值的执行上下文具有
| 组件 | 目的 |
|---|---|
| Generator |
此 |
在大多数情况下，只有
执行上下文纯粹是一种规范机制，不需要对应 ECMAScript 实现的任何特定工件。ECMAScript 代码不可能直接访问或观察执行上下文。
9.4.1 GetActiveScriptOrModule ( )
抽象操作 GetActiveScriptOrModule 不接收参数，并返回
9.4.2 ResolveBinding ( name [ , env ] )
抽象操作 ResolveBinding 接收参数 name（一个字符串）和可选参数 env（一个
- 如果 env 不存在或 env 是
undefined ，那么- 设置 env 为
运行执行上下文 的 LexicalEnvironment。
- 设置 env 为
断言 ： env 是一个环境记录 。- 设 strict 为
IsStrict （正在求值的语法产生式）。 - 返回 ?
GetIdentifierReference (env, name, strict)。
ResolveBinding 的结果始终是一个
9.4.3 GetThisEnvironment ( )
抽象操作 GetThisEnvironment 不接收参数，并返回一个this
绑定的
步骤this 绑定的全局环境结束。
9.4.5 ResolveThisBinding ( )
抽象操作 ResolveThisBinding 不接收参数，并返回this
的绑定。调用时执行以下步骤：
- 设 envRec 为
GetThisEnvironment ()。 - 返回 ? envRec.GetThisBinding()。
9.4.5 GetNewTarget ( )
抽象操作 GetNewTarget 不接收参数，并返回一个对象或
- 设 envRec 为
GetThisEnvironment ()。 断言 ： envRec 有一个 [[NewTarget]] 字段。- 返回 envRec.[[NewTarget]]。
9.4.6 GetGlobalObject ( )
抽象操作 GetGlobalObject 不接收参数，并返回一个对象。它返回当前
- 设 currentRealm 为
当前领域记录 。 - 返回 currentRealm.[[GlobalObject]]。
9.5 作业和宿主操作入队作业
作业是一个无参数的
- 在将来的某个时间点，当调度作业的
代理 中没有运行上下文且该代理 的执行上下文栈 为空时，实现必须： - 在
代理 中任何时间点只能有一个作业 在主动进行求值。 - 一旦
作业 的求值开始，它必须在代理 中任何其他作业 开始求值之前运行到完成。 抽象闭包 必须返回正常完成 ，实现自己的错误处理。
在任何特定时间，scriptOrModule（一个
GetActiveScriptOrModule () 是 scriptOrModule。- 如果 scriptOrModule 是
脚本记录 或模块记录 ，设 ec 为执行上下文栈 上 ScriptOrModule 组件为 scriptOrModule 的最顶层执行上下文 。ec 的领域 组件是 scriptOrModule.[[Realm]]。
在任何特定时间，如果所有以下条件都为真，则执行准备求值 ECMAScript 代码：
特定类型的
9.5.1 作业回调记录
作业回调记录是用于存储
例如，WHATWG HTML 规范（https://html.spec.whatwg.org/）使用
作业回调记录具有
9.5.2 HostMakeJobCallback ( callback )
HostMakeJobCallback 的实现必须符合以下要求：
- 它必须返回一个
作业回调记录 ，其[[Callback]]字段为callback。
HostMakeJobCallback 的默认实现在调用时执行以下步骤：
- 返回
作业回调记录 { [[Callback]]: callback, [[HostDefined]]:empty }。
非 Web 浏览器的 ECMAScript
这在回调被传递给负责其最终调度和运行的函数时调用。例如，promise.then(thenAction) 在调用
Promise.prototype.then 时对 thenAction 调用
MakeJobCallback，而不是在调度反应
9.5.3 HostCallJobCallback ( jobCallback, V, argumentsList )
HostCallJobCallback 的实现必须符合以下要求：
- 它必须执行并返回
Call (jobCallback.[[Callback]], V, argumentsList)的结果。
HostCallJobCallback 的默认实现在调用时执行以下步骤：
断言 ：IsCallable (jobCallback.[[Callback]]) 是true 。- 返回 ?
Call (jobCallback.[[Callback]], V, argumentsList)。
非 Web 浏览器的 ECMAScript
9.5.4 HostEnqueueGenericJob ( job, realm )
HostEnqueueGenericJob 的实现必须符合
9.5.5 HostEnqueuePromiseJob ( job, realm )
HostEnqueuePromiseJob 的实现必须符合
- 如果realm不是
null ，每次调用job时，实现必须执行实现定义 的步骤，使得在job调用时执行准备求值 ECMAScript 代码 。 - 设scriptOrModule为调用 HostEnqueuePromiseJob 时
GetActiveScriptOrModule ()的结果。如果realm不是null ，每次调用job时，实现必须执行实现定义 的步骤，使得scriptOrModule在job调用时是活动脚本或模块 。 作业 必须按照调度它们的 HostEnqueuePromiseJob 调用的相同顺序运行。
9.5.6 HostEnqueueTimeoutJob ( timeoutJob, realm, milliseconds )
HostEnqueueTimeoutJob 的实现必须符合
9.6 代理
代理包含一组 ECMAScript
例如，一些 Web 浏览器在浏览器窗口的多个不相关选项卡之间共享单个
当
代理标识符是用于标识
| 字段名称 | 值 | 含义 |
|---|---|---|
| [[LittleEndian]] | 布尔值 | 当算法 |
| [[CanBlock]] | 布尔值 | 确定 |
| [[Signifier]] | 一个 |
在其 |
| [[IsLockFree1]] | 布尔值 | 如果对单字节值的原子操作是无锁的，则为 |
| [[IsLockFree2]] | 布尔值 | 如果对双字节值的原子操作是无锁的，则为 |
| [[IsLockFree8]] | 布尔值 | 如果对八字节值的原子操作是无锁的，则为 |
| [[CandidateExecution]] | 一个 |
参见 |
| [[KeptAlive]] | 对象或符号的 |
初始为一个新的空 |
| [[ModuleAsyncEvaluationCount]] | 一个 |
初始为 0，用于为异步或具有异步依赖的模块的[[AsyncEvaluationOrder]]字段分配唯一的递增值。 |
一旦[[Signifier]]、[[IsLockFree1]]和[[IsLockFree2]]的值被
[[IsLockFree1]]和[[IsLockFree2]]的值不一定由硬件决定，也可能反映可能随时间和 ECMAScript 实现而变化的实现选择。
没有[[IsLockFree4]]字段：4 字节原子操作总是无锁的。
实际上，如果原子操作是用任何类型的锁实现的，则该操作不是无锁的。无锁并不意味着无等待：对于完成无锁原子操作可能需要多少个机器步骤没有上限。
大小为n的原子访问是无锁的，并不意味着大小为n的非原子访问的（感知的）原子性，具体来说，非原子访问仍然可能作为几个单独的内存访问序列来执行。详见
9.6.1 AgentSignifier ( )
抽象操作 AgentSignifier 不接收参数，并返回一个
9.6.2 AgentCanSuspend ( )
抽象操作 AgentCanSuspend 不接收参数，并返回一个布尔值。调用时执行以下步骤：
在某些环境中，给定
9.6.3 IncrementModuleAsyncEvaluationCount ( )
抽象操作 IncrementModuleAsyncEvaluationCount 不接收参数，并返回一个
此值仅用于跟踪挂起模块之间的相对求值顺序。当没有挂起模块时，实现可以不可观察地将[[ModuleAsyncEvaluationCount]]重置为 0。
9.7 代理集群
代理集群是可以通过操作共享内存进行通信的
每个
集群内的所有
如果代理集群内不同的
集群内的所有
集群内的所有
嵌入可以在
嵌入可以在
以下每个规范值以及从它们可传递到达的值都恰好属于一个代理集群。
在集群中任何
代理集群是一种规范机制，不需要对应 ECMAScript 实现的任何特定工件。
9.8 前进进度
当
实现必须确保：
9.9 WeakRef 和 FinalizationRegistry 目标的处理模型
9.9.1 目标
本规范不保证任何对象或符号会被垃圾回收。不
-
当调用
WeakRef.prototype.deref时，引用对象（如果未返回undefined ）被保持活跃，以便后续的同步访问也返回相同的值。使用ClearKeptObjects 抽象操作完成同步工作时，此列表被重置。 -
当向
FinalizationRegistry 注册的对象或符号变为不可达时，可能最终会在同步 ECMAScript 执行完成后调用FinalizationRegistry 的清理回调。FinalizationRegistry 清理通过CleanupFinalizationRegistry 抽象操作执行。
这两个动作（
一些 ECMAScript 实现包括在后台运行的垃圾收集器实现，包括当 ECMAScript 处于空闲状态时。让
9.9.2 活跃性
对于某个对象和/或符号集合S，关于S的假设 WeakRef
无关执行是指这样的执行：其引用对象是S元素的
在求值期间的任何时点，如果满足以下任一条件，则对象和/或符号集合S被认为是活跃的：
对象或符号在字段、内部槽或属性中的存在并不意味着该值是活跃的。例如，如果所讨论的值从未传回程序，那么它就无法被观察到。
WeakMap 中的键、WeakSet 的成员以及
上述定义意味着，如果 WeakMap 中的键不是活跃的，那么其对应的值也不一定是活跃的。
9.9.3 执行
在任何时候，如果对象和/或符号集合S不是
- 对于S的每个元素value，执行
- 对于每个ref.[[WeakRefTarget]]为value的
WeakRef ref，执行- 设置ref.[[WeakRefTarget]]为
empty 。
- 设置ref.[[WeakRefTarget]]为
- 对于每个fg.[[Cells]]包含cell.[[WeakRefTarget]]为value的
记录 cell的FinalizationRegistry fg，执行- 设置cell.[[WeakRefTarget]]为
empty 。 - 可选地，执行
HostEnqueueFinalizationRegistryCleanupJob (fg)。
- 设置cell.[[WeakRefTarget]]为
- 对于每个map.[[WeakMapData]]包含r.[[Key]]为value的
记录 r的 WeakMap map，执行- 设置r.[[Key]]为
empty 。 - 设置r.[[Value]]为
empty 。
- 设置r.[[Key]]为
- 对于每个set.[[WeakSetData]]包含value的
WeakSet set，执行
- 用值为
empty 的元素替换set.[[WeakSetData]]中值为value的元素。
- 用值为
- 对于每个ref.[[WeakRefTarget]]为value的
与活跃性定义一起，本条款规定了实现可以应用于
可以在不观察对象身份的情况下访问对象。诸如死变量消除和对身份未被观察的非逃逸对象属性的标量替换等优化是允许的。因此，这些优化被允许可观察地清空指向此类对象的
另一方面，如果对象的身份是可观察的，并且该对象在
因为调用
9.9.4 宿主钩子
9.9.4.1 HostEnqueueFinalizationRegistryCleanupJob ( finalizationRegistry )
设cleanupJob为捕获finalizationRegistry的无参数新
- 设cleanupResult为
Completion (CleanupFinalizationRegistry (finalizationRegistry))。 - 如果cleanupResult是
异常完成 ，执行任何宿主定义 的错误报告步骤。 - 返回
unused 。
HostEnqueueFinalizationRegistryCleanupJob
的实现调度cleanupJob在将来某个时间执行（如果可能）。它还必须符合
9.10 ClearKeptObjects ( )
抽象操作 ClearKeptObjects 不接收参数，并返回
9.11 AddToKeptObjects ( value )
抽象操作 AddToKeptObjects 接收参数value（一个对象或符号），并返回
9.12 CleanupFinalizationRegistry ( finalizationRegistry )
抽象操作 CleanupFinalizationRegistry 接收参数finalizationRegistry（一个
断言 ：finalizationRegistry具有[[Cells]]和[[CleanupCallback]]内部槽。- 设callback为finalizationRegistry.[[CleanupCallback]]。
- 当finalizationRegistry.[[Cells]]包含cell.[[WeakRefTarget]]为
empty 的记录 cell时，实现可以执行以下步骤：- 选择任何这样的cell。
- 从finalizationRegistry.[[Cells]]中移除cell。
- 执行?
HostCallJobCallback (callback,undefined , « cell.[[HeldValue]] »)。
- 返回
unused 。
9.13 CanBeHeldWeakly ( v )
抽象操作 CanBeHeldWeakly 接收参数v（一个
- 如果v
是对象 ，返回true 。 - 如果v
是符号 且KeyForSymbol (v)为undefined ，返回true 。 - 返回
false 。
没有
10 普通对象和异构对象行为
10.1 普通对象内部方法和内部槽
所有
每个
在以下算法描述中，假设O是一个
每个
10.1.1 [[GetPrototypeOf]] ( )
- 返回
OrdinaryGetPrototypeOf (O)。
10.1.1.1 OrdinaryGetPrototypeOf ( O )
抽象操作OrdinaryGetPrototypeOf接受参数O（一个Object），返回一个Object或
- 返回 O.[[Prototype]]。
10.1.2 [[SetPrototypeOf]] ( V )
- 返回
OrdinarySetPrototypeOf (O, V)。
10.1.2.1 OrdinarySetPrototypeOf ( O, V )
抽象操作OrdinarySetPrototypeOf接受参数O（一个Object）和V（一个Object或
- 令 current 为 O.[[Prototype]]。
- 如果
SameValue (V, current) 为true ，返回true 。 - 令 extensible 为 O.[[Extensible]]。
- 如果 extensible 为
false ，返回false 。 - 令 p 为 V。
- 令 done 为
false 。 - 重复，当 done 为
false 时， - 设置 O.[[Prototype]] 为 V。
- 返回
true 。
10.1.3 [[IsExtensible]] ( )
- 返回
OrdinaryIsExtensible (O)。
10.1.3.1 OrdinaryIsExtensible ( O )
抽象操作OrdinaryIsExtensible接受参数O（一个Object），返回一个Boolean。调用时执行以下步骤：
- 返回 O.[[Extensible]]。
10.1.4 [[PreventExtensions]] ( )
- 返回
OrdinaryPreventExtensions (O)。
10.1.4.1 OrdinaryPreventExtensions ( O )
抽象操作OrdinaryPreventExtensions接受参数O（一个Object），返回
- 设置 O.[[Extensible]] 为
false 。 - 返回
true 。
10.1.5 [[GetOwnProperty]] ( P )
- 返回
OrdinaryGetOwnProperty (O, P)。
10.1.5.1 OrdinaryGetOwnProperty ( O, P )
抽象操作OrdinaryGetOwnProperty接受参数O（一个Object）和P（一个
10.1.6 [[DefineOwnProperty]] ( P, Desc )
- 返回 ?
OrdinaryDefineOwnProperty (O, P, Desc)。
10.1.6.1 OrdinaryDefineOwnProperty ( O, P, Desc )
抽象操作OrdinaryDefineOwnProperty接受参数O（一个Object）、P（一个
- 令 current 为 ? O.[[GetOwnProperty]](P)。
- 令 extensible 为 ?
IsExtensible (O)。 - 返回
ValidateAndApplyPropertyDescriptor (O, P, extensible, Desc, current)。
10.1.6.2 IsCompatiblePropertyDescriptor ( Extensible, Desc, Current )
抽象操作IsCompatiblePropertyDescriptor接受参数Extensible（一个Boolean）、Desc（一个
- 返回
ValidateAndApplyPropertyDescriptor (undefined ,"" , Extensible, Desc, Current)。
10.1.6.3 ValidateAndApplyPropertyDescriptor ( O, P, extensible, Desc, current )
抽象操作ValidateAndApplyPropertyDescriptor接受参数O（一个Object或
断言 ：P是一个属性键 。- 如果 current 为
undefined ，那么- 如果 extensible 为
false ，返回false 。 - 如果 O 为
undefined ，返回true 。 - 如果
IsAccessorDescriptor (Desc) 为true ，那么 - 否则，
- 返回
true 。
- 如果 extensible 为
断言 ：current是一个完全填充的属性描述符 。- 如果 Desc 没有任何字段，返回
true 。 - 如果 current.[[Configurable]] 为
false ，那么- 如果 Desc 有[[Configurable]]字段且Desc.[[Configurable]] 为
true ，返回false 。 - 如果 Desc 有[[Enumerable]]字段且Desc.[[Enumerable]] 不等于 current.[[Enumerable]]，返回
false 。 - 如果
IsGenericDescriptor (Desc) 为false 且IsAccessorDescriptor (Desc) 不等于IsAccessorDescriptor (current)，返回false 。 - 如果
IsAccessorDescriptor (current) 为true ，那么 - 否则如果 current.[[Writable]] 为
false ，那么
- 如果 Desc 有[[Configurable]]字段且Desc.[[Configurable]] 为
- 如果 O 不是
undefined ，那么- 如果
IsDataDescriptor (current) 为true 且IsAccessorDescriptor (Desc) 为true ，那么- 如果 Desc 有[[Configurable]]字段，令 configurable 为 Desc.[[Configurable]]；否则令 configurable 为 current.[[Configurable]]。
- 如果 Desc 有[[Enumerable]]字段，令 enumerable 为 Desc.[[Enumerable]]；否则令 enumerable 为 current.[[Enumerable]]。
- 将对象O的名为P的属性替换为一个
访问器属性 ，其[[Configurable]]和[[Enumerable]]特性分别设置为configurable和enumerable，其[[Get]]和[[Set]]特性设置为Desc中对应字段的值（如果Desc有该字段），否则设置为该特性的默认值 。
- 否则如果
IsAccessorDescriptor (current) 为true 且IsDataDescriptor (Desc) 为true ，那么- 如果 Desc 有[[Configurable]]字段，令 configurable 为 Desc.[[Configurable]]；否则令 configurable 为 current.[[Configurable]]。
- 如果 Desc 有[[Enumerable]]字段，令 enumerable 为 Desc.[[Enumerable]]；否则令 enumerable 为 current.[[Enumerable]]。
- 将对象O的名为P的属性替换为一个
数据属性 ，其[[Configurable]]和[[Enumerable]]特性分别设置为configurable和enumerable，其[[Value]]和[[Writable]]特性设置为Desc中对应字段的值（如果Desc有该字段），否则设置为该特性的默认值 。
- 否则，
- 对于Desc的每个字段，将对象O的名为P的属性的对应特性设置为该字段的值。
- 如果
- 返回
true 。
10.1.7 [[HasProperty]] ( P )
- 返回 ?
OrdinaryHasProperty (O, P)。
10.1.7.1 OrdinaryHasProperty ( O, P )
抽象操作OrdinaryHasProperty接受参数O（一个Object）和P（一个
- 令 hasOwn 为 ? O.[[GetOwnProperty]](P)。
- 如果 hasOwn 不是
undefined ，返回true 。 - 令 parent 为 ? O.[[GetPrototypeOf]]()。
- 如果 parent 不是
null ，那么- 返回 ? parent.[[HasProperty]](P)。
- 返回
false 。
10.1.8 [[Get]] ( P, Receiver )
- 返回 ?
OrdinaryGet (O, P, Receiver)。
10.1.8.1 OrdinaryGet ( O, P, Receiver )
抽象操作OrdinaryGet接受参数O（一个Object）、P（一个
- 令 desc 为 ? O.[[GetOwnProperty]](P)。
- 如果 desc 为
undefined ，那么- 令 parent 为 ? O.[[GetPrototypeOf]]()。
- 如果 parent 为
null ，返回undefined 。 - 返回 ? parent.[[Get]](P, Receiver)。
- 如果
IsDataDescriptor (desc) 为true ，返回 desc.[[Value]]。 断言 ：IsAccessorDescriptor (desc) 为true 。- 令 getter 为 desc.[[Get]]。
- 如果 getter 为
undefined ，返回undefined 。 - 返回 ?
Call (getter, Receiver)。
10.1.9 [[Set]] ( P, V, Receiver )
- 返回 ?
OrdinarySet (O, P, V, Receiver)。
10.1.9.1 OrdinarySet ( O, P, V, Receiver )
抽象操作OrdinarySet接受参数O（一个Object）、P（一个
- 令 ownDesc 为 ? O.[[GetOwnProperty]](P)。
- 返回 ?
OrdinarySetWithOwnDescriptor (O, P, V, Receiver, ownDesc)。
10.1.9.2 OrdinarySetWithOwnDescriptor ( O, P, V, Receiver, ownDesc )
抽象操作OrdinarySetWithOwnDescriptor接受参数O（一个Object）、P（一个
- 如果 ownDesc 为
undefined ，那么- 令 parent 为 ? O.[[GetPrototypeOf]]()。
- 如果 parent 不是
null ，那么- 返回 ? parent.[[Set]](P, V, Receiver)。
- 否则，
- 设置 ownDesc 为属性描述符 { [[Value]]:
undefined , [[Writable]]:true , [[Enumerable]]:true , [[Configurable]]:true }。
- 设置 ownDesc 为属性描述符 { [[Value]]:
- 如果
IsDataDescriptor (ownDesc) 为true ，那么- 如果 ownDesc.[[Writable]] 为
false ，返回false 。 - 如果 Receiver
不是Object ，返回false 。 - 令 existingDescriptor 为 ? Receiver.[[GetOwnProperty]](P)。
- 如果 existingDescriptor 不是
undefined ，那么- 如果
IsAccessorDescriptor (existingDescriptor) 为true ，返回false 。 - 如果 existingDescriptor.[[Writable]] 为
false ， 返回false 。 - 令 valueDesc 为属性描述符 { [[Value]]: V }。
- 返回 ? Receiver.[[DefineOwnProperty]](P, valueDesc)。
- 如果
- 否则，
断言 ：Receiver 当前没有属性 P。- 返回 ?
CreateDataProperty (Receiver, P, V)。
- 如果 ownDesc.[[Writable]] 为
断言 ：IsAccessorDescriptor (ownDesc) 为true 。- 令 setter 为 ownDesc.[[Set]]。
- 如果 setter 为
undefined ，返回false 。 - 执行 ?
Call (setter, Receiver, « V »)。 - 返回
true 。
10.1.10 [[Delete]] ( P )
- 返回 ?
OrdinaryDelete (O, P)。
10.1.10.1 OrdinaryDelete ( O, P )
抽象操作OrdinaryDelete接受参数O（一个Object）和P（一个
- 令 desc 为 ? O.[[GetOwnProperty]](P)。
- 如果 desc 为
undefined ，返回true 。 - 如果 desc.[[Configurable]] 为
true ，那么- 从 O 中移除名为 P 的自有属性。
- 返回
true 。
- 返回
false 。
10.1.11 [[OwnPropertyKeys]] ( )
- 返回
OrdinaryOwnPropertyKeys (O)。
10.1.11.1 OrdinaryOwnPropertyKeys ( O )
抽象操作OrdinaryOwnPropertyKeys接受参数O（一个Object），返回一个
10.1.12 OrdinaryObjectCreate ( proto [ , additionalInternalSlotsList ] )
抽象操作OrdinaryObjectCreate接受参数proto（一个Object或
- 令 internalSlotsList 为 « [[Prototype]], [[Extensible]] »。
- 如果 additionalInternalSlotsList 存在，设置 internalSlotsList 为
internalSlotsList 和 additionalInternalSlotsList 的
列表连接 。 - 令 O 为
MakeBasicObject (internalSlotsList)。 - 设置 O.[[Prototype]] 为 proto。
- 返回 O。
虽然OrdinaryObjectCreate除了调用
10.1.13 OrdinaryCreateFromConstructor ( constructor, intrinsicDefaultProto [ , internalSlotsList ] )
抽象操作OrdinaryCreateFromConstructor接受参数constructor（一个
断言 ：intrinsicDefaultProto是本规范的内在对象名称。对应的对象必须是旨在用作对象的[[Prototype]]值的内在值。- 令 proto 为 ?
GetPrototypeFromConstructor (constructor, intrinsicDefaultProto)。 - 如果 internalSlotsList 存在，令 slotsList 为 internalSlotsList。
- 否则，令 slotsList 为一个新的空
列表 。 - 返回
OrdinaryObjectCreate (proto, slotsList)。
10.1.14 GetPrototypeFromConstructor ( constructor, intrinsicDefaultProto )
抽象操作GetPrototypeFromConstructor接受参数constructor（一个
断言 ：intrinsicDefaultProto是本规范的内在对象名称。对应的对象必须是旨在用作对象的[[Prototype]]值的内在值。- 令 proto 为 ?
Get (constructor,"prototype" )。 - 如果 proto
不是Object ，那么- 令 realm 为 ?
GetFunctionRealm (constructor)。 - 设置 proto 为 realm 的名为 intrinsicDefaultProto 的内在对象。
- 令 realm 为 ?
- 返回 proto。
10.1.15 RequireInternalSlot ( O, internalSlot )
抽象操作RequireInternalSlot接受参数O（一个
- 如果 O
不是Object ，抛出TypeError 异常。 - 如果 O 没有 internalSlot 内部插槽，抛出
TypeError 异常。 - 返回
unused 。
10.2 ECMAScript函数对象
ECMAScript
除了[[Extensible]]和[[Prototype]]之外，ECMAScript
| 内部插槽 | 类型 | 描述 |
|---|---|---|
| [[Environment]] |
一个 |
函数封闭的 |
| [[PrivateEnvironment]] |
一个 |
函数封闭的 |
| [[FormalParameters]] |
一个 |
定义函数形式参数列表的源文本的根解析节点。 |
| [[ECMAScriptCode]] |
一个 |
定义函数体的源文本的根解析节点。 |
| [[ConstructorKind]] |
|
函数是否为派生类 |
| [[Realm]] |
一个 |
创建函数的 |
| [[ScriptOrModule]] |
一个 |
创建函数的脚本或模块。 |
| [[ThisMode]] |
|
定义如何在函数的形式参数和代码体中解释this引用。this引用词法封闭函数的 |
| [[Strict]] | 一个Boolean |
如果这是 |
| [[HomeObject]] | 一个Object |
如果函数使用super，这是其[[GetPrototypeOf]]提供super属性查找开始的对象的对象。
|
| [[SourceText]] | Unicode代码点序列 |
定义函数的 |
| [[Fields]] |
|
如果函数是类，这是表示类的非静态字段和相应初始化器的 |
| [[PrivateMethods]] |
|
如果函数是类，这是表示类的非静态私有方法和访问器的列表。 |
| [[ClassFieldInitializerName]] |
一个字符串、一个Symbol、一个 |
如果函数是作为类字段的初始化器创建的，则为字段的 |
| [[IsClassConstructor]] | 一个Boolean |
指示函数是否为类 |
所有ECMAScript
10.2.1 [[Call]] ( thisArgument, argumentsList )
ECMAScript
- 令 callerContext 为
运行执行上下文 。 - 令 calleeContext 为
PrepareForOrdinaryCall (F,undefined )。 断言 ：calleeContext现在是运行执行上下文 。- 如果 F.[[IsClassConstructor]] 为
true ，那么- 令 error 为新创建的
TypeError 对象。 - 注：error在calleeContext中使用F的关联
领域记录 创建。 - 从
执行上下文栈 中移除calleeContext并恢复callerContext为运行执行上下文 。 - 返回
ThrowCompletion (error)。
- 令 error 为新创建的
- 执行
OrdinaryCallBindThis (F, calleeContext, thisArgument)。 - 令 result 为
Completion (OrdinaryCallEvaluateBody (F, argumentsList))。 - 从
执行上下文栈 中移除calleeContext并恢复callerContext为运行执行上下文 。 - 如果 result 是
返回完成 ，返回 result.[[Value]]。 断言 ：result是抛出完成 。- 返回 ? result。
10.2.1.1 PrepareForOrdinaryCall ( F, newTarget )
抽象操作PrepareForOrdinaryCall接受参数F（一个ECMAScript
- 令 callerContext 为
运行执行上下文 。 - 令 calleeContext 为新的
ECMAScript代码执行上下文 。 - 设置 calleeContext 的Function为 F。
- 令 calleeRealm 为 F.[[Realm]]。
- 设置 calleeContext 的
领域 为 calleeRealm。 - 设置 calleeContext 的ScriptOrModule为 F.[[ScriptOrModule]]。
- 令 localEnv 为
NewFunctionEnvironment (F, newTarget)。 - 设置 calleeContext 的LexicalEnvironment为 localEnv。
- 设置 calleeContext 的VariableEnvironment为 localEnv。
- 设置 calleeContext 的PrivateEnvironment为 F.[[PrivateEnvironment]]。
- 如果 callerContext 尚未挂起，挂起 callerContext。
- 将 calleeContext 推入
执行上下文栈 ；calleeContext现在是运行执行上下文 。 - 注：此点之后产生的任何异常对象都与 calleeRealm 关联。
- 返回 calleeContext。
10.2.1.2 OrdinaryCallBindThis ( F, calleeContext, thisArgument )
抽象操作OrdinaryCallBindThis接受参数F（一个ECMAScript
- 令 thisMode 为 F.[[ThisMode]]。
- 如果 thisMode 为
lexical ，返回unused 。 - 令 calleeRealm 为 F.[[Realm]]。
- 令 localEnv 为 calleeContext 的LexicalEnvironment。
- 如果 thisMode 为
strict ，那么- 令 thisValue 为 thisArgument。
- 否则，
断言 ：localEnv是函数环境记录 。断言 ：下一步永远不会返回突然完成 ，因为localEnv.[[ThisBindingStatus]]不是initialized 。- 执行 !
BindThisValue (localEnv, thisValue)。 - 返回
unused 。
10.2.1.3 运行时语义：EvaluateBody
- 返回 ?
FunctionBody 的EvaluateFunctionBody ，参数为 functionObject 和 argumentsList。
- 返回 ?
ConciseBody 的EvaluateConciseBody ，参数为 functionObject 和 argumentsList。
- 返回 ?
GeneratorBody 的EvaluateGeneratorBody ，参数为 functionObject 和 argumentsList。
- 返回 ?
AsyncGeneratorBody 的EvaluateAsyncGeneratorBody ，参数为 functionObject 和 argumentsList。
- 返回 ?
AsyncFunctionBody 的EvaluateAsyncFunctionBody ，参数为 functionObject 和 argumentsList。
- 返回 ?
AsyncConciseBody 的EvaluateAsyncConciseBody ，参数为 functionObject 和 argumentsList。
断言 ：argumentsList为空。断言 ：functionObject.[[ClassFieldInitializerName]]不是empty 。- 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 为true ，那么- 令 value 为 ?
Initializer 的NamedEvaluation ，参数为 functionObject.[[ClassFieldInitializerName]]。
- 令 value 为 ?
- 否则，
- 令 rhs 为 ?
AssignmentExpression 的Evaluation 。 - 令 value 为 ?
GetValue (rhs)。
- 令 rhs 为 ?
- 返回
ReturnCompletion (value)。
尽管字段初始化器构成函数边界，但调用
断言 ：argumentsList为空。- 返回 ?
ClassStaticBlockBody 的EvaluateClassStaticBlockBody ，参数为 functionObject。
10.2.1.4 OrdinaryCallEvaluateBody ( F, argumentsList )
抽象操作OrdinaryCallEvaluateBody接受参数F（一个ECMAScript
- 返回 ? F.[[ECMAScriptCode]] 的
EvaluateBody ，参数为 F 和 argumentsList。
10.2.2 [[Construct]] ( argumentsList, newTarget )
ECMAScript
- 令 callerContext 为
运行执行上下文 。 - 令 kind 为 F.[[ConstructorKind]]。
- 如果 kind 为
base ，那么- 令 thisArgument 为 ?
OrdinaryCreateFromConstructor (newTarget,"%Object.prototype%" )。
- 令 thisArgument 为 ?
- 令 calleeContext 为
PrepareForOrdinaryCall (F, newTarget)。 断言 ：calleeContext现在是运行执行上下文 。- 如果 kind 为
base ，那么- 执行
OrdinaryCallBindThis (F, calleeContext, thisArgument)。 - 令 initializeResult 为
Completion (InitializeInstanceElements (thisArgument, F))。 - 如果 initializeResult 是
突然完成 ，那么
- 执行
- 令 constructorEnv 为 calleeContext 的LexicalEnvironment。
- 令 result 为
Completion (OrdinaryCallEvaluateBody (F, argumentsList))。 - 从
执行上下文栈 中移除calleeContext并恢复callerContext为运行执行上下文 。 - 如果 result 是
抛出完成 ，那么- 返回 ? result。
断言 ：result是返回完成 。- 如果 result.[[Value]]
是Object ，返回 result.[[Value]]。 - 如果 kind 为
base ，返回 thisArgument。 - 如果 result.[[Value]] 不是
undefined ，抛出TypeError 异常。 - 令 thisBinding 为 ? constructorEnv.GetThisBinding()。
断言 ：thisBinding是Object 。- 返回 thisBinding。
10.2.3 OrdinaryFunctionCreate ( functionPrototype, sourceText, ParameterList, Body, thisMode, env, privateEnv )
抽象操作OrdinaryFunctionCreate接受参数functionPrototype（一个Object）、sourceText（Unicode代码点序列）、ParameterList（一个
- 令 internalSlotsList 为
表30 中列出的内部插槽。 - 令 F 为
OrdinaryObjectCreate (functionPrototype, internalSlotsList)。 - 设置 F.[[Call]] 为
10.2.1 中指定的定义。 - 设置 F.[[SourceText]] 为 sourceText。
- 设置 F.[[FormalParameters]] 为 ParameterList。
- 设置 F.[[ECMAScriptCode]] 为 Body。
- 令 Strict 为
IsStrict (Body)。 - 设置 F.[[Strict]] 为 Strict。
- 如果 thisMode 为
lexical-this ，设置 F.[[ThisMode]] 为lexical 。 - 否则，如果 Strict 为
true ，设置 F.[[ThisMode]] 为strict 。 - 否则，设置 F.[[ThisMode]] 为
global 。 - 设置 F.[[IsClassConstructor]] 为
false 。 - 设置 F.[[Environment]] 为 env。
- 设置 F.[[PrivateEnvironment]] 为 privateEnv。
- 设置 F.[[ScriptOrModule]] 为
GetActiveScriptOrModule ()。 - 设置 F.[[Realm]] 为
当前领域记录 。 - 设置 F.[[HomeObject]] 为
undefined 。 - 设置 F.[[Fields]] 为新的空
列表 。 - 设置 F.[[PrivateMethods]] 为新的空
列表 。 - 设置 F.[[ClassFieldInitializerName]] 为
empty 。 - 令 len 为 ParameterList 的
ExpectedArgumentCount 。 - 执行
SetFunctionLength (F, len)。 - 返回 F。
10.2.4 AddRestrictedFunctionProperties ( F, realm )
抽象操作AddRestrictedFunctionProperties接受参数F（一个
断言 ：realm.[[Intrinsics]].[[%ThrowTypeError% ]]存在且已被初始化。- 令 thrower 为 realm.[[Intrinsics]].[[
%ThrowTypeError% ]]。 - 执行 !
DefinePropertyOrThrow (F,"caller" , PropertyDescriptor { [[Get]]: thrower, [[Set]]: thrower, [[Enumerable]]:false , [[Configurable]]:true })。 - 执行 !
DefinePropertyOrThrow (F,"arguments" , PropertyDescriptor { [[Get]]: thrower, [[Set]]: thrower, [[Enumerable]]:false , [[Configurable]]:true })。 - 返回
unused 。
10.2.4.1 %ThrowTypeError% ( )
此函数是%ThrowTypeError%内在对象。
调用时执行以下步骤：
- 抛出
TypeError 异常。
此函数的[[Extensible]]内部插槽的值为
此函数的
此函数的
10.2.5 MakeConstructor ( F [ , writablePrototype [ , prototype ] ] )
抽象操作MakeConstructor接受参数F（一个ECMAScript
- 如果 F 是ECMAScript
函数对象 ，那么断言 ：IsConstructor (F) 为false 。断言 ：F是一个可扩展对象，且没有"prototype" 自身属性。- 设置 F.[[Construct]] 为
10.2.2 中指定的定义。
- 否则，
- 设置 F.[[Construct]] 为
10.3.2 中指定的定义。
- 设置 F.[[Construct]] 为
- 设置 F.[[ConstructorKind]] 为
base 。 - 如果 writablePrototype 不存在，设置 writablePrototype 为
true 。 - 如果 prototype 不存在，那么
- 设置 prototype 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
DefinePropertyOrThrow (prototype,"constructor" , PropertyDescriptor { [[Value]]: F, [[Writable]]: writablePrototype, [[Enumerable]]:false , [[Configurable]]:true })。
- 设置 prototype 为
- 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]: writablePrototype, [[Enumerable]]:false , [[Configurable]]:false })。 - 返回
unused 。
10.2.6 MakeClassConstructor ( F )
抽象操作MakeClassConstructor接受参数F（一个ECMAScript
断言 ：F.[[IsClassConstructor]] 为false 。- 设置 F.[[IsClassConstructor]] 为
true 。 - 返回
unused 。
10.2.7 MakeMethod ( F, homeObject )
抽象操作MakeMethod接受参数F（一个ECMAScript
10.2.8 DefineMethodProperty ( homeObject, key, closure, enumerable )
抽象操作DefineMethodProperty接受参数homeObject（一个Object）、key（一个
断言 ：homeObject是普通的、可扩展的对象。- 如果 key 是
私有名称 ，那么- 返回
私有元素 { [[Key]]: key, [[Kind]]:method , [[Value]]: closure }。
- 返回
- 否则，
- 令 desc 为PropertyDescriptor { [[Value]]:
closure, [[Writable]]:
true , [[Enumerable]]: enumerable, [[Configurable]]:true }。 - 执行 ?
DefinePropertyOrThrow (homeObject, key, desc)。 - 注：
DefinePropertyOrThrow 仅在尝试定义key为"prototype" 的类静态方法时返回突然完成 。 - 返回
unused 。
- 令 desc 为PropertyDescriptor { [[Value]]:
closure, [[Writable]]:
10.2.9 SetFunctionName ( F, name [ , prefix ] )
抽象操作SetFunctionName接受参数F（一个
断言 ：F是可扩展对象且没有"name" 自身属性。- 如果 name
是Symbol ，那么- 令 description 为 name 的[[Description]]值。
- 如果 description 为
undefined ，设置 name 为空字符串。 - 否则，设置 name
为
"[" 、description和"]" 的字符串连接 。
- 否则，如果 name 是
私有名称 ，那么- 设置 name 为 name.[[Description]]。
- 如果 F 有[[InitialName]]内部插槽，那么
- 设置 F.[[InitialName]] 为 name。
- 如果 prefix 存在，那么
- 设置 name 为prefix、代码单元0x0020（空格）和name的
字符串连接 。 - 如果 F 有[[InitialName]]内部插槽，那么
- 可选地，设置 F.[[InitialName]] 为 name。
- 设置 name 为prefix、代码单元0x0020（空格）和name的
- 执行 !
DefinePropertyOrThrow (F,"name" , PropertyDescriptor { [[Value]]: name, [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:true })。 - 返回
unused 。
10.2.10 SetFunctionLength ( F, length )
抽象操作SetFunctionLength接受参数F（一个
断言 ：F是可扩展对象且没有"length" 自身属性。- 执行 !
DefinePropertyOrThrow (F,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:true })。 - 返回
unused 。
10.2.11 FunctionDeclarationInstantiation ( func, argumentsList )
抽象操作FunctionDeclarationInstantiation接受参数func（一个ECMAScript
调用时执行以下步骤：
- 令 calleeContext 为
运行执行上下文 。 - 令 code 为 func.[[ECMAScriptCode]]。
- 令 strict 为 func.[[Strict]]。
- 令 formals 为 func.[[FormalParameters]]。
- 令 parameterNames 为 formals 的
BoundNames 。 - 如果 parameterNames 有任何重复条目，令 hasDuplicates 为
true 。否则，令 hasDuplicates 为false 。 - 令 simpleParameterList 为 formals 的
IsSimpleParameterList 。 - 令 hasParameterExpressions 为 formals 的
ContainsExpression 。 - 令 varNames 为 code 的
VarDeclaredNames 。 - 令 varDeclarations 为 code 的
VarScopedDeclarations 。 - 令 lexicalNames 为 code 的
LexicallyDeclaredNames 。 - 令 functionNames 为新的空
列表 。 - 令 functionsToInitialize 为新的空
列表 。 - 对于 varDeclarations 的每个元素 d，按反向
列表 顺序，执行- 如果 d 既不是
VariableDeclaration ，也不是ForBinding ，也不是BindingIdentifier ，那么断言 ：d 要么是FunctionDeclaration ，要么是GeneratorDeclaration ，要么是AsyncFunctionDeclaration ，要么是AsyncGeneratorDeclaration 。- 令 fn 为 d 的
BoundNames 的唯一元素。 - 如果 functionNames 不包含 fn，那么
- 将 fn 作为第一个元素插入 functionNames。
- 注：如果有多个同名函数声明，使用最后一个声明。
- 将 d 作为第一个元素插入 functionsToInitialize。
- 如果 d 既不是
- 令 argumentsObjectNeeded 为
true 。 - 如果 func.[[ThisMode]] 为
lexical ，那么- 注：箭头函数从不有arguments对象。
- 设置 argumentsObjectNeeded 为
false 。
- 否则，如果 parameterNames 包含
"arguments" ，那么- 设置 argumentsObjectNeeded 为
false 。
- 设置 argumentsObjectNeeded 为
- 否则，如果 hasParameterExpressions 为
false ，那么- 如果 functionNames 包含
"arguments" 或 lexicalNames 包含"arguments" ，那么- 设置 argumentsObjectNeeded 为
false 。
- 设置 argumentsObjectNeeded 为
- 如果 functionNames 包含
- 如果 strict 为
true 或 hasParameterExpressions 为false ，那么 - 否则，
- 注：需要单独的
环境记录 以确保形参列表中直接eval 调用创建的绑定位于声明参数的环境之外。 - 令 calleeEnv 为 calleeContext 的LexicalEnvironment。
- 令 env 为
NewDeclarativeEnvironment (calleeEnv)。 断言 ：calleeContext 的VariableEnvironment和 calleeEnv 是同一个环境记录 。- 设置 calleeContext 的LexicalEnvironment为 env。
- 注：需要单独的
- 对于 parameterNames 的每个字符串 paramName，执行
- 如果 argumentsObjectNeeded 为
true ，那么- 如果 strict 为
true 或 simpleParameterList 为false ，那么- 令 ao 为
CreateUnmappedArgumentsObject (argumentsList)。
- 令 ao 为
- 否则，
- 注：映射的参数对象仅为没有剩余参数、任何参数默认值初始化器或任何解构参数的
非严格函数 提供。 - 令 ao 为
CreateMappedArgumentsObject (func, formals, argumentsList, env)。
- 注：映射的参数对象仅为没有剩余参数、任何参数默认值初始化器或任何解构参数的
- 如果 strict 为
true ，那么 - 否则，
- 执行
! env.CreateMutableBinding(
"arguments" ,false )。
- 执行
! env.CreateMutableBinding(
- 执行 ! env.InitializeBinding(
"arguments" , ao)。 - 令 parameterBindings 为 parameterNames 和 «
"arguments" » 的列表连接 。
- 如果 strict 为
- 否则，
- 令 parameterBindings 为 parameterNames。
- 令 iteratorRecord 为
CreateListIteratorRecord (argumentsList)。 - 如果 hasDuplicates 为
true ，那么- 执行 ? formals 的
IteratorBindingInitialization ，参数为 iteratorRecord 和undefined 。
- 执行 ? formals 的
- 否则，
- 执行 ? formals 的
IteratorBindingInitialization ，参数为 iteratorRecord 和 env。
- 执行 ? formals 的
- 如果 hasParameterExpressions 为
false ，那么 - 否则，
- 注：需要单独的
环境记录 以确保形参列表中表达式创建的闭包不能看到函数体中的声明。 - 令 varEnv 为
NewDeclarativeEnvironment (env)。 - 设置 calleeContext 的VariableEnvironment为 varEnv。
- 令 instantiatedVarNames 为新的空
列表 。 - 对于 varNames 的每个元素 n，执行
- 如果 instantiatedVarNames 不包含 n，那么
- 将 n 追加到 instantiatedVarNames。
- 执行 ! varEnv.CreateMutableBinding(n,
false )。 - 如果 parameterBindings 不包含 n，或如果
functionNames 包含 n，那么
- 令 initialValue 为
undefined 。
- 令 initialValue 为
- 否则，
- 令 initialValue 为
! env.GetBindingValue(n,
false )。
- 令 initialValue 为
! env.GetBindingValue(n,
- 执行 ! varEnv.InitializeBinding(n, initialValue)。
- 注：与形参同名的var最初具有与相应初始化参数相同的值。
- 如果 instantiatedVarNames 不包含 n，那么
- 注：需要单独的
- 注：附录
B.3.2.1 在此处添加了额外的步骤。 - 如果 strict 为
false ，那么 - 否则，
- 令 lexEnv 为 varEnv。
- 设置 calleeContext 的LexicalEnvironment为 lexEnv。
- 令 lexDeclarations 为 code 的
LexicallyScopedDeclarations 。 - 对于 lexDeclarations 的每个元素 d，执行
- 注：词法声明的名称不能与函数/生成器声明、形参或var名称相同。词法声明的名称仅在此处实例化但未初始化。
- 对于 d 的
BoundNames 的每个元素 dn，执行- 如果 d 的
IsConstantDeclaration 为true ，那么- 执行
! lexEnv.CreateImmutableBinding(dn,
true )。
- 执行
! lexEnv.CreateImmutableBinding(dn,
- 否则，
- 执行 ! lexEnv.CreateMutableBinding(dn,
false )。
- 执行 ! lexEnv.CreateMutableBinding(dn,
- 如果 d 的
- 令 privateEnv 为 calleeContext 的PrivateEnvironment。
- 对于 functionsToInitialize 的每个
解析节点 f，执行- 令 fn 为 f 的
BoundNames 的唯一元素。 - 令 fo 为 f 的
InstantiateFunctionObject ，参数为 lexEnv 和 privateEnv。 - 执行 ! varEnv.SetMutableBinding(fn, fo,
false )。
- 令 fn 为 f 的
- 返回
unused 。
10.3 内置函数对象
内置
除了每个
内置
内置
内置
实现可以提供本规范中未定义的其他内置
10.3.1 [[Call]] ( thisArgument, argumentsList )
内置
- 返回 ?
BuiltinCallOrConstruct (F, thisArgument, argumentsList,undefined )。
10.3.2 [[Construct]] ( argumentsList, newTarget )
内置
- 令 result 为 ?
BuiltinCallOrConstruct (F,uninitialized , argumentsList, newTarget)。 断言 ：result是Object 。- 返回 result。
10.3.3 BuiltinCallOrConstruct ( F, thisArgument, argumentsList, newTarget )
抽象操作BuiltinCallOrConstruct接受参数F（内置
- 令 callerContext 为
运行执行上下文 。 - 如果 callerContext 尚未被挂起，挂起 callerContext。
- 令 calleeContext 为新的
执行上下文 。 - 设置 calleeContext 的Function为 F。
- 令 calleeRealm 为 F.[[Realm]]。
- 设置 calleeContext 的
领域 为 calleeRealm。 - 设置 calleeContext 的ScriptOrModule为
null 。 - 执行 calleeContext 的任何必要的
实现定义的 初始化。 - 将 calleeContext 推入
执行上下文栈 ；calleeContext 现在是运行执行上下文 。 - 令 result 为
完成记录 ，其为评估结果，以符合 F 规范的方式评估 F。如果 thisArgument 为uninitialized ，则this 值未初始化；否则，thisArgument 提供this 值。argumentsList 提供具名参数。newTarget 提供NewTarget值。 - 注：如果 F 在本文档中定义，"F 的规范"是通过算法步骤或其他方式为其指定的行为。
- 从
执行上下文栈 中移除 calleeContext 并将 callerContext 恢复为运行执行上下文 。 - 返回 ? result。
当从
10.3.4 CreateBuiltinFunction ( behaviour, length, name, additionalInternalSlotsList [ , realm [ , prototype [ , prefix ] ] ] )
抽象操作CreateBuiltinFunction接受参数behaviour（
- 如果 realm 不存在，设置 realm 为
当前领域记录 。 - 如果 prototype 不存在，设置 prototype 为
realm.[[Intrinsics]].[[
%Function.prototype% ]]。 - 令 internalSlotsList 为
列表 ，包含10.3 为即将创建的内置函数对象 所需的所有内部插槽的名称。 - 将 additionalInternalSlotsList 的元素追加到 internalSlotsList。
- 令 func 为新的内置
函数对象 ，当调用时，使用提供的参数作为 behaviour 指定的相应参数的值，执行 behaviour 描述的操作。新的函数对象 具有名称为 internalSlotsList 元素的内部插槽，以及 [[InitialName]] 内部插槽。 - 设置 func.[[Prototype]] 为 prototype。
- 设置 func.[[Extensible]] 为
true 。 - 设置 func.[[Realm]] 为 realm。
- 设置 func.[[InitialName]] 为
null 。 - 执行
SetFunctionLength (func, length)。 - 如果 prefix 不存在，那么
- 执行
SetFunctionName (func, name)。
- 执行
- 否则，
- 执行
SetFunctionName (func, name, prefix)。
- 执行
- 返回 func。
本规范中定义的每个内置函数都是通过调用CreateBuiltinFunction抽象操作创建的。
10.4 内置异质对象内部方法和插槽
本规范定义了几种内置
10.4.1 绑定函数异质对象
如果对象的[[Call]]和（如果适用）[[Construct]]内部方法使用以下实现，其他基本内部方法使用
| 内部插槽 | 类型 | 描述 |
|---|---|---|
| [[BoundTargetFunction]] | 可调用对象 |
被包装的 |
| [[BoundThis]] |
|
调用包装函数时总是作为 |
| [[BoundArguments]] |
|
一个值列表，其元素用作对包装函数的任何调用的前几个参数。 |
10.4.1.1 [[Call]] ( thisArgument, argumentsList )
10.4.1.2 [[Construct]] ( argumentsList, newTarget )
- 令 target 为 F.[[BoundTargetFunction]]。
断言 ：IsConstructor (target) 为true 。- 令 boundArgs 为 F.[[BoundArguments]]。
- 令 args 为 boundArgs 和 argumentsList 的
列表连接 。 - 如果
SameValue (F, newTarget) 为true ，设置 newTarget 为 target。 - 返回 ?
Construct (target, args, newTarget)。
10.4.1.3 BoundFunctionCreate ( targetFunction, boundThis, boundArgs )
抽象操作BoundFunctionCreate接受参数targetFunction（
- 令 proto 为 ? targetFunction.[[GetPrototypeOf]]()。
- 令 internalSlotsList 为 « [[Prototype]], [[Extensible]] » 和
表31 中列出的内部插槽的列表连接 。 - 令 obj 为
MakeBasicObject (internalSlotsList)。 - 设置 obj.[[Prototype]] 为 proto。
- 按照
10.4.1.1 中的描述设置 obj.[[Call]]。 - 如果
IsConstructor (targetFunction) 为true ，那么- 按照
10.4.1.2 中的描述设置 obj.[[Construct]]。
- 按照
- 设置 obj.[[BoundTargetFunction]] 为 targetFunction。
- 设置 obj.[[BoundThis]] 为 boundThis。
- 设置 obj.[[BoundArguments]] 为 boundArgs。
- 返回 obj。
10.4.2 数组异质对象
数组是一个
如果对象的[[DefineOwnProperty]]内部方法使用以下实现，其他基本内部方法使用
10.4.2.1 [[DefineOwnProperty]] ( P, Desc )
- 如果 P 是
"length" ，那么- 返回 ?
ArraySetLength (A, Desc)。
- 返回 ?
- 否则，如果 P 是
数组索引 ，那么- 令 lengthDesc 为
OrdinaryGetOwnProperty (A,"length" )。 断言 ：lengthDesc 不是undefined 。断言 ：IsDataDescriptor (lengthDesc) 为true 。断言 ：lengthDesc.[[Configurable]] 为false 。- 令 length 为 lengthDesc.[[Value]]。
断言 ：length 是非负整数 。- 令 index 为 !
ToUint32 (P)。 - 如果 index ≥ length 且 lengthDesc.[[Writable]] 为
false ，返回false 。 - 令 succeeded 为 !
OrdinaryDefineOwnProperty (A, P, Desc)。 - 如果 succeeded 为
false ，返回false 。 - 如果 index ≥ length，那么
- 设置 lengthDesc.[[Value]] 为
index +
1 𝔽。 - 设置 succeeded 为 !
OrdinaryDefineOwnProperty (A,"length" , lengthDesc)。 断言 ：succeeded 为true 。
- 设置 lengthDesc.[[Value]] 为
index +
- 返回
true 。
- 令 lengthDesc 为
- 返回 ?
OrdinaryDefineOwnProperty (A, P, Desc)。
10.4.2.2 ArrayCreate ( length [ , proto ] )
抽象操作ArrayCreate接受参数length（非负
- 如果 length > 232 - 1，抛出
RangeError 异常。 - 如果 proto 不存在，设置 proto 为
%Array.prototype% 。 - 令 A 为
MakeBasicObject (« [[Prototype]], [[Extensible]] »)。 - 设置 A.[[Prototype]] 为 proto。
- 按照
10.4.2.1 中指定的设置 A.[[DefineOwnProperty]]。 - 执行 !
OrdinaryDefineOwnProperty (A,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 A。
10.4.2.3 ArraySpeciesCreate ( originalArray, length )
抽象操作ArraySpeciesCreate接受参数originalArray（对象）和length（非负
- 令 isArray 为 ?
IsArray (originalArray)。 - 如果 isArray 为
false ，返回 ?ArrayCreate (length)。 - 令 C 为 ?
Get (originalArray,"constructor" )。 - 如果
IsConstructor (C) 为true ，那么- 令 thisRealm 为
当前领域记录 。 - 令 realmC 为 ?
GetFunctionRealm (C)。 - 如果 thisRealm 和 realmC 不是同一个
领域记录 ，那么
- 令 thisRealm 为
- 如果 C
是对象 ，那么- 设置 C 为 ?
Get (C,%Symbol.species% )。 - 如果 C 为
null ，设置 C 为undefined 。
- 设置 C 为 ?
- 如果 C 为
undefined ，返回 ?ArrayCreate (length)。 - 如果
IsConstructor (C) 为false ，抛出TypeError 异常。 - 返回 ?
Construct (C, «𝔽 (length) »)。
10.4.2.4 ArraySetLength ( A, Desc )
抽象操作ArraySetLength接受参数A（数组）和Desc（
- 如果 Desc 没有 [[Value]] 字段，那么
- 返回 !
OrdinaryDefineOwnProperty (A,"length" , Desc)。
- 返回 !
- 令 newLenDesc 为 Desc 的副本。
- 令 newLen 为 ?
ToUint32 (Desc.[[Value]])。 - 令 numberLen 为 ?
ToNumber (Desc.[[Value]])。 - 如果
SameValueZero (newLen, numberLen) 为false ，抛出RangeError 异常。 - 设置 newLenDesc.[[Value]] 为 newLen。
- 令 oldLenDesc 为
OrdinaryGetOwnProperty (A,"length" )。 断言 ：oldLenDesc 不是undefined 。断言 ：IsDataDescriptor (oldLenDesc) 为true 。断言 ：oldLenDesc.[[Configurable]] 为false 。- 令 oldLen 为 oldLenDesc.[[Value]]。
- 如果 newLen ≥ oldLen，那么
- 返回 !
OrdinaryDefineOwnProperty (A,"length" , newLenDesc)。
- 返回 !
- 如果 oldLenDesc.[[Writable]] 为
false ，返回false 。 - 如果 newLenDesc 没有 [[Writable]] 字段或
newLenDesc.[[Writable]] 为
true ，那么- 令 newWritable 为
true 。
- 令 newWritable 为
- 否则，
- 注：如果任何元素无法删除，将[[Writable]]属性设置为
false 会被延迟。 - 令 newWritable 为
false 。 - 设置 newLenDesc.[[Writable]] 为
true 。
- 注：如果任何元素无法删除，将[[Writable]]属性设置为
- 令 succeeded 为 !
OrdinaryDefineOwnProperty (A,"length" , newLenDesc)。 - 如果 succeeded 为
false ，返回false 。 - 对于 A 的每个自有
属性键 P，如果 P 是数组索引 且 !ToUint32 (P) ≥ newLen，按数值索引降序执行- 令 deleteSucceeded 为 ! A.[[Delete]](P)。
- 如果 deleteSucceeded 为
false ，那么- 设置 newLenDesc.[[Value]] 为
!
ToUint32 (P) +1 𝔽。 - 如果 newWritable 为
false ，设置 newLenDesc.[[Writable]] 为false 。 - 执行 !
OrdinaryDefineOwnProperty (A,"length" , newLenDesc)。 - 返回
false 。
- 设置 newLenDesc.[[Value]] 为
!
- 如果 newWritable 为
false ，那么- 设置 succeeded 为 !
OrdinaryDefineOwnProperty (A,"length" , PropertyDescriptor { [[Writable]]:false })。 断言 ：succeeded 为true 。
- 设置 succeeded 为 !
- 返回
true 。
10.4.3 字符串异质对象
字符串对象是一个
如果对象的[[GetOwnProperty]]、[[DefineOwnProperty]]和[[OwnPropertyKeys]]内部方法使用以下实现，其他基本内部方法使用
10.4.3.1 [[GetOwnProperty]] ( P )
- 令 desc 为
OrdinaryGetOwnProperty (S, P)。 - 如果 desc 不是
undefined ，返回 desc。 - 返回
StringGetOwnProperty (S, P)。
10.4.3.2 [[DefineOwnProperty]] ( P, Desc )
- 令 stringDesc 为
StringGetOwnProperty (S, P)。 - 如果 stringDesc 不是
undefined ，那么- 令 extensible 为 S.[[Extensible]]。
- 返回
IsCompatiblePropertyDescriptor (extensible, Desc, stringDesc)。
- 返回 !
OrdinaryDefineOwnProperty (S, P, Desc)。
10.4.3.3 [[OwnPropertyKeys]] ( )
- 令 keys 为新的空
列表 。 - 令 str 为 O.[[StringData]]。
断言 ：str是字符串 。- 令 len 为 str 的长度。
- 对于每个
整数 i，0 ≤ i < len，按升序执行 - 对于 O 的每个自有
属性键 P，如果 P 是数组索引 且 !ToIntegerOrInfinity (P) ≥ len，按数值索引升序执行- 将 P 追加到 keys。
- 对于 O 的每个自有
属性键 P，如果 P是字符串 且 P 不是数组索引 ，按属性创建的时间升序执行- 将 P 追加到 keys。
- 对于 O 的每个自有
属性键 P，如果 P是Symbol ，按属性创建的时间升序执行- 将 P 追加到 keys。
- 返回 keys。
10.4.3.4 StringCreate ( value, prototype )
抽象操作StringCreate接受参数value（字符串）和prototype（对象），返回
- 令 S 为
MakeBasicObject (« [[Prototype]], [[Extensible]], [[StringData]] »)。 - 设置 S.[[Prototype]] 为 prototype。
- 设置 S.[[StringData]] 为 value。
- 按照
10.4.3.1 中指定的设置 S.[[GetOwnProperty]]。 - 按照
10.4.3.2 中指定的设置 S.[[DefineOwnProperty]]。 - 按照
10.4.3.3 中指定的设置 S.[[OwnPropertyKeys]]。 - 令 length 为 value 的长度。
- 执行 !
DefinePropertyOrThrow (S,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 S。
10.4.3.5 StringGetOwnProperty ( S, P )
抽象操作StringGetOwnProperty接受参数S（具有[[StringData]]内部插槽的对象）和P（
- 如果 P
不是字符串 ，返回undefined 。 - 令 index 为
CanonicalNumericIndexString (P)。 - 如果 index 不是
整数 ，返回undefined 。 - 如果 index 是
-0 𝔽 或 index <-0 𝔽，返回undefined 。 - 令 str 为 S.[[StringData]]。
断言 ：str是字符串 。- 令 len 为 str 的长度。
- 如果
ℝ (index) ≥ len，返回undefined 。 - 令 resultStr 为 str 从
ℝ (index) 到ℝ (index) + 1 的子字符串 。 - 返回 PropertyDescriptor { [[Value]]: resultStr,
[[Writable]]:
false , [[Enumerable]]:true , [[Configurable]]:false }。
10.4.4 Arguments 异质对象
大多数ECMAScript函数向其代码提供一个arguments对象。根据函数定义的特征，其arguments对象要么是
如果对象的内部方法使用以下实现，其他未在此指定的方法使用
虽然
Object.prototype.toString（
ParameterMap对象及其属性值被用作指定arguments对象与参数绑定对应关系的设备。ParameterMap对象和作为其属性值的对象不能从ECMAScript代码中直接观察到。ECMAScript实现不需要实际创建或使用此类对象来实现指定的语义。
普通arguments对象定义一个名为
10.4.4.1 [[GetOwnProperty]] ( P )
- 令 desc 为
OrdinaryGetOwnProperty (args, P)。 - 如果 desc 是
undefined ，返回undefined 。 - 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, P)。 - 如果 isMapped 为
true ，那么- 设置 desc.[[Value]] 为 !
Get (map, P)。
- 设置 desc.[[Value]] 为 !
- 返回 desc。
10.4.4.2 [[DefineOwnProperty]] ( P, Desc )
- 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, P)。 - 令 newArgDesc 为 Desc。
- 如果 isMapped 为
true 且IsDataDescriptor (Desc) 为true ，那么- 如果 Desc 没有 [[Value]] 字段，Desc
有 [[Writable]] 字段，且 Desc.[[Writable]] 为
false ，那么- 设置 newArgDesc 为 Desc 的副本。
- 设置 newArgDesc.[[Value]] 为
!
Get (map, P)。
- 如果 Desc 没有 [[Value]] 字段，Desc
有 [[Writable]] 字段，且 Desc.[[Writable]] 为
- 令 allowed 为 !
OrdinaryDefineOwnProperty (args, P, newArgDesc)。 - 如果 allowed 为
false ，返回false 。 - 如果 isMapped 为
true ，那么- 如果
IsAccessorDescriptor (Desc) 为true ，那么- 执行 ! map.[[Delete]](P)。
- 否则，
- 如果
- 返回
true 。
10.4.4.3 [[Get]] ( P, Receiver )
- 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, P)。 - 如果 isMapped 为
false ，那么- 返回 ?
OrdinaryGet (args, P, Receiver)。
- 返回 ?
- 否则，
10.4.4.4 [[Set]] ( P, V, Receiver )
- 如果
SameValue (args, Receiver) 为false ，那么- 令 isMapped 为
false 。
- 令 isMapped 为
- 否则，
- 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, P)。
- 如果 isMapped 为
true ，那么 - 返回 ?
OrdinarySet (args, P, V, Receiver)。
10.4.4.5 [[Delete]] ( P )
- 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, P)。 - 令 result 为 ?
OrdinaryDelete (args, P)。 - 如果 result 为
true 且 isMapped 为true ，那么- 执行 ! map.[[Delete]](P)。
- 返回 result。
10.4.4.6 CreateUnmappedArgumentsObject ( argumentsList )
抽象操作CreateUnmappedArgumentsObject接受参数argumentsList（
- 令 len 为 argumentsList 中元素的数量。
- 令 obj 为
OrdinaryObjectCreate (%Object.prototype% , « [[ParameterMap]] »)。 - 设置 obj.[[ParameterMap]] 为
undefined 。 - 执行 !
DefinePropertyOrThrow (obj,"length" , PropertyDescriptor { [[Value]]:𝔽 (len), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })。 - 令 index 为 0。
- 重复，当 index < len 时，
- 令 val 为 argumentsList[index]。
- 执行 !
CreateDataPropertyOrThrow (obj, !ToString (𝔽 (index)), val)。 - 设置 index 为 index + 1。
- 执行 !
DefinePropertyOrThrow (obj,%Symbol.iterator% , PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })。 - 执行 !
DefinePropertyOrThrow (obj,"callee" , PropertyDescriptor { [[Get]]:%ThrowTypeError% , [[Set]]:%ThrowTypeError% , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 obj。
10.4.4.7 CreateMappedArgumentsObject ( func, formals, argumentsList, env )
抽象操作CreateMappedArgumentsObject接受参数func（对象）、formals（
断言 ：formals 不包含剩余参数、任何绑定模式或任何初始化器。它可能包含重复标识符。- 令 len 为 argumentsList 中元素的数量。
- 令 obj 为
MakeBasicObject (« [[Prototype]], [[Extensible]], [[ParameterMap]] »)。 - 按照
10.4.4.1 中指定的设置 obj.[[GetOwnProperty]]。 - 按照
10.4.4.2 中指定的设置 obj.[[DefineOwnProperty]]。 - 按照
10.4.4.3 中指定的设置 obj.[[Get]]。 - 按照
10.4.4.4 中指定的设置 obj.[[Set]]。 - 按照
10.4.4.5 中指定的设置 obj.[[Delete]]。 - 设置 obj.[[Prototype]] 为
%Object.prototype% 。 - 令 map 为
OrdinaryObjectCreate (null )。 - 设置 obj.[[ParameterMap]] 为 map。
- 令 parameterNames 为 formals 的
BoundNames 。 - 令 numberOfParameters 为 parameterNames 中元素的数量。
- 令 index 为 0。
- 重复，当 index < len 时，
- 令 val 为 argumentsList[index]。
- 执行 !
CreateDataPropertyOrThrow (obj, !ToString (𝔽 (index)), val)。 - 设置 index 为 index + 1。
- 执行 !
DefinePropertyOrThrow (obj,"length" , PropertyDescriptor { [[Value]]:𝔽 (len), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })。 - 令 mappedNames 为新的空
列表 。 - 设置 index 为 numberOfParameters - 1。
- 重复，当 index ≥ 0 时，
- 令 name 为 parameterNames[index]。
- 如果 mappedNames 不包含 name，那么
- 将 name 追加到 mappedNames。
- 如果 index < len，那么
- 令 g 为
MakeArgGetter (name, env)。 - 令 p 为
MakeArgSetter (name, env)。 - 执行 ! map.[[DefineOwnProperty]](!
ToString (𝔽 (index)), PropertyDescriptor { [[Set]]: p, [[Get]]: g, [[Enumerable]]:false , [[Configurable]]:true })。
- 令 g 为
- 设置 index 为 index - 1。
- 执行 !
DefinePropertyOrThrow (obj,%Symbol.iterator% , PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })。 - 执行 !
DefinePropertyOrThrow (obj,"callee" , PropertyDescriptor { [[Value]]: func, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })。 - 返回 obj。
10.4.4.7.1 MakeArgGetter ( name, env )
抽象操作MakeArgGetter接受参数name（字符串）和env（
- 令 getterClosure 为新的
抽象闭包 ，没有参数，捕获name和env，调用时执行以下步骤：- 返回 env.GetBindingValue(name,
false )。
- 返回 env.GetBindingValue(name,
- 令 getter 为
CreateBuiltinFunction (getterClosure, 0,"" , « »)。 - 注：getter 从不直接被ECMAScript代码访问。
- 返回 getter。
10.4.4.7.2 MakeArgSetter ( name, env )
抽象操作MakeArgSetter接受参数name（字符串）和env（
- 令 setterClosure 为新的
抽象闭包 ，参数为(value)，捕获name和env，调用时执行以下步骤：- 返回 ! env.SetMutableBinding(name,
value,
false )。
- 返回 ! env.SetMutableBinding(name,
value,
- 令 setter 为
CreateBuiltinFunction (setterClosure, 1,"" , « »)。 - 注：setter 从不直接被ECMAScript代码访问。
- 返回 setter。
10.4.5 TypedArray 异质对象
因为对于任何数字 n，
如果一个对象的 [[PreventExtensions]]、[[GetOwnProperty]]、[[HasProperty]]、[[DefineOwnProperty]]、[[Get]]、[[Set]]、[[Delete]] 和 [[OwnPropertyKeys]] 内部方法使用本节中的定义，并且其他基本内部方法使用
10.4.5.1 [[PreventExtensions]] ( )
- 注：
6.1.7.3 中指定的可扩展性相关的不变性不允许此方法在 O 可以获得（或失去然后重新获得）属性时返回true ，这可能发生在当其底层缓冲区被调整大小时具有整数索引 名称的属性上。 - 如果
IsTypedArrayFixedLength (O) 是false ，返回false 。 - 返回
OrdinaryPreventExtensions (O)。
10.4.5.2 [[GetOwnProperty]] ( P )
- 如果 P
是一个字符串 ，那么- 让 numericIndex 为
CanonicalNumericIndexString (P)。 - 如果 numericIndex 不是
undefined ，那么- 让 value 为
TypedArrayGetElement (O, numericIndex)。 - 如果 value 是
undefined ，返回undefined 。 - 返回属性描述符 { [[Value]]:
value，[[Writable]]:
true ，[[Enumerable]]:true ，[[Configurable]]:true }。
- 让 value 为
- 让 numericIndex 为
- 返回
OrdinaryGetOwnProperty (O, P)。
10.4.5.3 [[HasProperty]] ( P )
- 如果 P
是一个字符串 ，那么- 让 numericIndex 为
CanonicalNumericIndexString (P)。 - 如果 numericIndex 不是
undefined ，返回IsValidIntegerIndex (O, numericIndex)。
- 让 numericIndex 为
- 返回 ?
OrdinaryHasProperty (O, P)。
10.4.5.4 [[DefineOwnProperty]] ( P, Desc )
- 如果 P
是一个字符串 ，那么- 让 numericIndex 为
CanonicalNumericIndexString (P)。 - 如果 numericIndex 不是
undefined ，那么- 如果
IsValidIntegerIndex (O, numericIndex) 是false ，返回false 。 - 如果 Desc 有一个 [[Configurable]]
字段且 Desc.[[Configurable]]
是
false ，返回false 。 - 如果 Desc 有一个 [[Enumerable]]
字段且 Desc.[[Enumerable]] 是
false ，返回false 。 - 如果
IsAccessorDescriptor (Desc) 是true ，返回false 。 - 如果 Desc 有一个 [[Writable]] 字段
且 Desc.[[Writable]] 是
false ，返回false 。 - 如果 Desc 有一个 [[Value]] 字段，
执行 ?
TypedArraySetElement (O, numericIndex, Desc.[[Value]])。 - 返回
true 。
- 如果
- 让 numericIndex 为
- 返回 !
OrdinaryDefineOwnProperty (O, P, Desc)。
10.4.5.5 [[Get]] ( P, Receiver )
- 如果 P
是一个字符串 ，那么- 让 numericIndex 为
CanonicalNumericIndexString (P)。 - 如果 numericIndex 不是
undefined ，那么- 返回
TypedArrayGetElement (O, numericIndex)。
- 返回
- 让 numericIndex 为
- 返回 ?
OrdinaryGet (O, P, Receiver)。
10.4.5.6 [[Set]] ( P, V, Receiver )
- 如果 P
是一个字符串 ，那么- 让 numericIndex 为
CanonicalNumericIndexString (P)。 - 如果 numericIndex 不是
undefined ，那么- 如果
SameValue (O, Receiver) 是true ，那么- 执行 ?
TypedArraySetElement (O, numericIndex, V)。 - 返回
true 。
- 执行 ?
- 如果
IsValidIntegerIndex (O, numericIndex) 是false ，返回true 。
- 如果
- 让 numericIndex 为
- 返回 ?
OrdinarySet (O, P, V, Receiver)。
10.4.5.7 [[Delete]] ( P )
- 如果 P
是一个字符串 ，那么- 让 numericIndex 为
CanonicalNumericIndexString (P)。 - 如果 numericIndex 不是
undefined ，那么- 如果
IsValidIntegerIndex (O, numericIndex) 是false ，返回true ；否则返回false 。
- 如果
- 让 numericIndex 为
- 返回 !
OrdinaryDelete (O, P)。
10.4.5.8 [[OwnPropertyKeys]] ( )
- 让 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 让 keys 为一个新的空
列表 。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是false ，那么- 让 length 为
TypedArrayLength (taRecord)。 - 对于每个满足 0 ≤ i < length 的
整数 i，按升序，执行
- 让 length 为
- 对于 O 的每个自己的
属性键 P，使得 P是一个字符串 且 P 不是一个整数索引 ，按属性创建的升序时间顺序，执行- 将 P 追加到 keys。
- 对于 O 的每个自己的
属性键 P，使得 P是一个符号 ，按属性创建的升序时间顺序，执行- 将 P 追加到 keys。
- 返回 keys。
10.4.5.9 TypedArray 带缓冲区见证记录
TypedArray
带缓冲区见证记录 是一个用于封装
TypedArray 带缓冲区见证记录具有
| 字段名称 | 值 | 含义 |
|---|---|---|
| [[Object]] |
一个 |
其缓冲区字节长度被加载的 |
| [[CachedBufferByteLength]] |
一个非负 |
创建 |
10.4.5.10 MakeTypedArrayWithBufferWitnessRecord ( obj, order )
抽象操作 MakeTypedArrayWithBufferWitnessRecord 接受参数 obj（一个
- 让 buffer 为 obj.[[ViewedArrayBuffer]]。
- 如果
IsDetachedBuffer (buffer) 是true ，那么- 让 byteLength 为
detached 。
- 让 byteLength 为
- 否则，
- 让 byteLength 为
ArrayBufferByteLength (buffer, order)。
- 让 byteLength 为
- 返回
TypedArray 带缓冲区见证记录 { [[Object]]: obj, [[CachedBufferByteLength]]: byteLength }。
10.4.5.11 TypedArrayCreate ( prototype )
抽象操作 TypedArrayCreate 接受参数 prototype（一个对象）并返回一个
- 让 internalSlotsList 为 « [[Prototype]]、[[Extensible]]、[[ViewedArrayBuffer]]、[[TypedArrayName]]、[[ContentType]]、[[ByteLength]]、 [[ByteOffset]]、[[ArrayLength]] »。
- 让 A 为
MakeBasicObject (internalSlotsList)。 - 设置 A.[[PreventExtensions]] 如
10.4.5.1 中所指定。 - 设置 A.[[GetOwnProperty]] 如
10.4.5.2 中所指定。 - 设置 A.[[HasProperty]] 如
10.4.5.3 中所指定。 - 设置 A.[[DefineOwnProperty]] 如
10.4.5.4 中所指定。 - 设置 A.[[Get]] 如
10.4.5.5 中所指定。 - 设置 A.[[Set]] 如
10.4.5.6 中所指定。 - 设置 A.[[Delete]] 如
10.4.5.7 中所指定。 - 设置 A.[[OwnPropertyKeys]] 如
10.4.5.8 中所指定。 - 设置 A.[[Prototype]] 为 prototype。
- 返回 A。
10.4.5.12 TypedArrayByteLength ( taRecord )
抽象操作 TypedArrayByteLength 接受参数 taRecord（一个
- 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，返回 0。 - 让 length 为
TypedArrayLength (taRecord)。 - 如果 length = 0，返回 0。
- 让 O 为 taRecord.[[Object]]。
- 如果 O.[[ByteLength]] 不是
auto ，返回 O.[[ByteLength]]。 - 让 elementSize 为
TypedArrayElementSize (O)。 - 返回 length × elementSize。
10.4.5.13 TypedArrayLength ( taRecord )
抽象操作 TypedArrayLength 接受参数 taRecord（一个
断言 ：IsTypedArrayOutOfBounds (taRecord) 是false 。- 让 O 为 taRecord.[[Object]]。
- 如果 O.[[ArrayLength]] 不是
auto ，返回 O.[[ArrayLength]]。 断言 ：IsFixedLengthArrayBuffer (O.[[ViewedArrayBuffer]]) 是false 。- 让 byteOffset 为 O.[[ByteOffset]]。
- 让 elementSize 为
TypedArrayElementSize (O)。 - 让 byteLength 为 taRecord.[[CachedBufferByteLength]]。
断言 ： byteLength 不是detached 。- 返回
floor ((byteLength - byteOffset) / elementSize)。
10.4.5.14 IsTypedArrayOutOfBounds ( taRecord )
抽象操作 IsTypedArrayOutOfBounds 接受参数 taRecord（一个
- 让 O 为 taRecord.[[Object]]。
- 让 bufferByteLength 为 taRecord.[[CachedBufferByteLength]]。
断言 ：IsDetachedBuffer (O.[[ViewedArrayBuffer]]) 是true 当且仅当 bufferByteLength 是detached 。- 如果 bufferByteLength 是
detached ，返回true 。 - 让 byteOffsetStart 为 O.[[ByteOffset]]。
- 如果 O.[[ArrayLength]] 是
auto ，那么- 让 byteOffsetEnd 为 bufferByteLength。
- 否则，
- 让 elementSize 为
TypedArrayElementSize (O)。 - 让 byteOffsetEnd 为 byteOffsetStart + O.[[ArrayLength]] × elementSize。
- 让 elementSize 为
- 如果 byteOffsetStart > bufferByteLength 或
byteOffsetEnd > bufferByteLength，返回
true 。 - 注：0长度的
TypedArrays 不被认为是越界的。 - 返回
false 。
10.4.5.15 IsTypedArrayFixedLength ( O )
抽象操作 IsTypedArrayFixedLength 接受参数 O（一个
- 如果 O.[[ArrayLength]] 是
auto ，返回false 。 - 让 buffer 为 O.[[ViewedArrayBuffer]]。
- 如果
IsFixedLengthArrayBuffer (buffer) 是false 且IsSharedArrayBuffer (buffer) 是false ，返回false 。 - 返回
true 。
10.4.5.16 IsValidIntegerIndex ( O, index )
抽象操作 IsValidIntegerIndex 接受参数 O（一个
- 如果
IsDetachedBuffer (O.[[ViewedArrayBuffer]]) 是true ，返回false 。 - 如果 index 不是一个
整数数字 ，返回false 。 - 如果 index 是
-0 𝔽 或 index <-0 𝔽，返回false 。 - 让 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,unordered )。 - 注：当 O 的支持缓冲区是
可增长的 SharedArrayBuffer 时，边界检查不是同步操作。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，返回false 。 - 让 length 为
TypedArrayLength (taRecord)。 - 如果
ℝ (index) ≥ length，返回false 。 - 返回
true 。
10.4.5.17 TypedArrayGetElement ( O, index )
抽象操作 TypedArrayGetElement 接受参数 O（一个
- 如果
IsValidIntegerIndex (O, index) 是false ，返回undefined 。 - 让 offset 为 O.[[ByteOffset]]。
- 让 elementSize 为
TypedArrayElementSize (O)。 - 让 byteIndexInBuffer 为 (
ℝ (index) × elementSize) + offset。 - 让 elementType 为
TypedArrayElementType (O)。 - 返回
GetValueFromBuffer (O.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType,true ,unordered )。
10.4.5.18 TypedArraySetElement ( O, index, value )
抽象操作 TypedArraySetElement 接受参数 O（一个
- 如果 O.[[ContentType]] 是
bigint ，让 numValue 为 ?ToBigInt (value)。 - 否则，让 numValue 为 ?
ToNumber (value)。 - 如果
IsValidIntegerIndex (O, index) 是true ，那么- 让 offset 为 O.[[ByteOffset]]。
- 让 elementSize 为
TypedArrayElementSize (O)。 - 让 byteIndexInBuffer 为 (
ℝ (index) × elementSize) + offset。 - 让 elementType 为
TypedArrayElementType (O)。 - 执行
SetValueInBuffer (O.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType, numValue,true ,unordered )。
- 返回
unused 。
此操作总是显得成功，但是当尝试写入
10.4.5.19 IsArrayBufferViewOutOfBounds ( O )
抽象操作 IsArrayBufferViewOutOfBounds 接受参数 O（一个
- 如果 O 有一个 [[DataView]] 内部插槽，那么
- 让 viewRecord 为
MakeDataViewWithBufferWitnessRecord (O,seq-cst )。 - 返回
IsViewOutOfBounds (viewRecord)。
- 让 viewRecord 为
- 让 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 返回
IsTypedArrayOutOfBounds (taRecord)。
10.4.6 模块命名空间异质对象
export * 导出项间接导出的任何绑定。每个字符串值自己的
如果一个对象的 [[GetPrototypeOf]]、[[SetPrototypeOf]]、[[IsExtensible]]、[[PreventExtensions]]、[[GetOwnProperty]]、[[DefineOwnProperty]]、[[HasProperty]]、[[Get]]、[[Set]]、[[Delete]] 和 [[OwnPropertyKeys]]
内部方法使用本节中的定义，并且其他基本内部方法使用
10.4.6.1 [[GetPrototypeOf]] ( )
- 返回
null 。
10.4.6.2 [[SetPrototypeOf]] ( V )
- 返回 !
SetImmutablePrototype (O, V)。
10.4.6.3 [[IsExtensible]] ( )
- 返回
false 。
10.4.6.4 [[PreventExtensions]] ( )
- 返回
true 。
10.4.6.5 [[GetOwnProperty]] ( P )
- 如果 P
是一个符号 ，返回OrdinaryGetOwnProperty (O, P)。 - 让 exports 为 O.[[Exports]]。
- 如果 exports 不包含 P，返回
undefined 。 - 让 value 为 ? O.[[Get]](P, O)。
- 返回属性描述符 { [[Value]]: value、[[Writable]]:
true 、[[Enumerable]]:true 、[[Configurable]]:false }。
10.4.6.6 [[DefineOwnProperty]] ( P, Desc )
- 如果 P
是一个符号 ，返回 !OrdinaryDefineOwnProperty (O, P, Desc)。 - 让 current 为 ? O.[[GetOwnProperty]](P)。
- 如果 current 是
undefined ，返回false 。 - 如果 Desc 有一个 [[Configurable]] 字段且
Desc.[[Configurable]] 是
true ，返回false 。 - 如果 Desc 有一个 [[Enumerable]] 字段且
Desc.[[Enumerable]] 是
false ，返回false 。 - 如果
IsAccessorDescriptor (Desc) 是true ，返回false 。 - 如果 Desc 有一个 [[Writable]] 字段且
Desc.[[Writable]] 是
false ，返回false 。 - 如果 Desc 有一个 [[Value]] 字段，返回
SameValue (Desc.[[Value]], current.[[Value]])。 - 返回
true 。
10.4.6.7 [[HasProperty]] ( P )
- 如果 P
是一个符号 ，返回 !OrdinaryHasProperty (O, P)。 - 让 exports 为 O.[[Exports]]。
- 如果 exports 包含 P，返回
true 。 - 返回
false 。
10.4.6.8 [[Get]] ( P, Receiver )
- 如果 P
是一个符号 ，那么- 返回 !
OrdinaryGet (O, P, Receiver)。
- 返回 !
- 让 exports 为 O.[[Exports]]。
- 如果 exports 不包含 P，返回
undefined 。 - 让 m 为 O.[[Module]]。
- 让 binding 为 m.ResolveExport(P)。
断言 ： binding 是一个ResolvedBinding 记录 。- 让 targetModule 为 binding.[[Module]]。
断言 ： targetModule 不是undefined 。- 如果 binding.[[BindingName]] 是
namespace ，那么- 返回
GetModuleNamespace (targetModule)。
- 返回
- 让 targetEnv 为 targetModule.[[Environment]]。
- 如果 targetEnv 是
empty ，抛出一个ReferenceError 异常。 - 返回 ? targetEnv.GetBindingValue(binding.[[BindingName]],
true )。
ResolveExport 是无副作用的。每当使用特定的 exportName、resolveSet
对作为参数调用此操作时，它必须返回相同的结果。实现可能选择预计算或缓存每个
10.4.6.9 [[Set]] ( P, V, Receiver )
- 返回
false 。
10.4.6.10 [[Delete]] ( P )
- 如果 P
是一个符号 ，那么- 返回 !
OrdinaryDelete (O, P)。
- 返回 !
- 让 exports 为 O.[[Exports]]。
- 如果 exports 包含 P，返回
false 。 - 返回
true 。
10.4.6.11 [[OwnPropertyKeys]] ( )
- 让 exports 为 O.[[Exports]]。
- 让 symbolKeys 为
OrdinaryOwnPropertyKeys (O)。 - 返回 exports 和 symbolKeys 的
列表连接 。
10.4.6.12 ModuleNamespaceCreate ( module, exports )
抽象操作 ModuleNamespaceCreate 接受参数 module（一个
断言 ： module.[[Namespace]] 是empty 。- 让 internalSlotsList 为
表 33 中列出的内部插槽。 - 让 M 为
MakeBasicObject (internalSlotsList)。 - 设置 M 的基本内部方法为
10.4.6 中指定的定义。 - 设置 M.[[Module]] 为 module。
- 让 sortedExports 为一个
列表 ，其元素是 exports 的元素，按字典代码单元顺序 排序。 - 设置 M.[[Exports]] 为 sortedExports。
- 创建 M 的自己的属性，对应于
28.3 中的定义。 - 设置 module.[[Namespace]] 为 M。
- 返回 M。
10.4.7 不可变原型异质对象
如果一个对象的 [[SetPrototypeOf]] 内部方法使用以下实现，则该对象是一个 不可变原型异质对象。（其他基本内部方法可以使用任何实现，取决于所涉及的特定
与其他
10.4.7.1 [[SetPrototypeOf]] ( V )
- 返回 ?
SetImmutablePrototype (O, V)。
10.4.7.2 SetImmutablePrototype ( O, V )
抽象操作 SetImmutablePrototype 接受参数 O（一个对象）和 V（一个对象或
- 让 current 为 ? O.[[GetPrototypeOf]]()。
- 如果
SameValue (V, current) 是true ，返回true 。 - 返回
false 。
10.5 代理对象内部方法和内部插槽
代理对象是一个
如果一个对象的基本内部方法（包括 [[Call]] 和 [[Construct]]，如果适用）使用本节中的定义，则该对象是一个 代理异质对象。这些内部方法在
| 内部方法 | 处理器方法 |
|---|---|
| [[GetPrototypeOf]] |
getPrototypeOf
|
| [[SetPrototypeOf]] |
setPrototypeOf
|
| [[IsExtensible]] |
isExtensible
|
| [[PreventExtensions]] |
preventExtensions
|
| [[GetOwnProperty]] |
getOwnPropertyDescriptor
|
| [[DefineOwnProperty]] |
defineProperty
|
| [[HasProperty]] |
has
|
| [[Get]] |
get
|
| [[Set]] |
set
|
| [[Delete]] |
deleteProperty
|
| [[OwnPropertyKeys]] |
ownKeys
|
| [[Call]] |
apply
|
| [[Construct]] |
construct
|
当调用处理器方法来提供代理对象内部方法的实现时，处理器方法将代理的目标对象作为参数传递。代理的处理器对象不一定具有与每个基本内部方法相对应的方法。如果处理器对象没有与内部陷阱相对应的方法，则在代理上调用内部方法会导致在代理的目标对象上调用相应的内部方法。
代理对象的 [[ProxyHandler]] 和 [[ProxyTarget]]
内部插槽在创建对象时总是被初始化，通常不能被修改。某些代理对象以允许它们随后被撤销的方式创建。当代理被撤销时，其 [[ProxyHandler]] 和 [[ProxyTarget]] 内部插槽被设置为
因为代理对象允许通过任意 ECMAScript 代码提供内部方法的实现，所以可以定义一个代理对象，其处理器方法违反了
在以下算法描述中，假设 O 是一个 ECMAScript 代理对象，P 是一个
10.5.1 [[GetPrototypeOf]] ( )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"getPrototypeOf" )。 - 如果 trap 是
undefined ，那么- 返回 ? target.[[GetPrototypeOf]]()。
- 让 handlerProto 为 ?
Call (trap, handler, « target »)。 - 如果 handlerProto
不是一个对象 且 handlerProto 不是null ，抛出一个TypeError 异常。 - 让 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 extensibleTarget 是
true ，返回 handlerProto。 - 让 targetProto 为 ? target.[[GetPrototypeOf]]()。
- 如果
SameValue (handlerProto, targetProto) 是false ，抛出一个TypeError 异常。 - 返回 handlerProto。
代理对象的 [[GetPrototypeOf]] 强制执行以下不变量：
-
[[GetPrototypeOf]] 的结果必须是一个对象或
null 。 - 如果目标对象不可扩展，应用于代理对象的 [[GetPrototypeOf]] 必须返回与应用于代理对象的目标对象的 [[GetPrototypeOf]] 相同的值。
10.5.2 [[SetPrototypeOf]] ( V )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"setPrototypeOf" )。 - 如果 trap 是
undefined ，那么- 返回 ? target.[[SetPrototypeOf]](V)。
- 让 booleanTrapResult 为
ToBoolean (?Call (trap, handler, « target, V »))。 - 如果 booleanTrapResult 是
false ，返回false 。 - 让 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 extensibleTarget 是
true ，返回true 。 - 让 targetProto 为 ? target.[[GetPrototypeOf]]()。
- 如果
SameValue (V, targetProto) 是false ，抛出一个TypeError 异常。 - 返回
true 。
代理对象的 [[SetPrototypeOf]] 强制执行以下不变量：
-
[[SetPrototypeOf]] 的结果
是一个布尔值 。 - 如果目标对象不可扩展，参数值必须与应用于目标对象的 [[GetPrototypeOf]] 的结果相同。
10.5.3 [[IsExtensible]] ( )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"isExtensible" )。 - 如果 trap 是
undefined ，那么- 返回 ?
IsExtensible (target)。
- 返回 ?
- 让 booleanTrapResult 为
ToBoolean (?Call (trap, handler, « target »))。 - 让 targetResult 为 ?
IsExtensible (target)。 - 如果 booleanTrapResult 不是 targetResult，抛出一个
TypeError 异常。 - 返回 booleanTrapResult。
代理对象的 [[IsExtensible]] 强制执行以下不变量：
-
[[IsExtensible]] 的结果
是一个布尔值 。 - 应用于代理对象的 [[IsExtensible]] 必须返回与应用于代理对象的目标对象的 [[IsExtensible]] 相同的值。
10.5.4 [[PreventExtensions]] ( )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"preventExtensions" )。 - 如果 trap 是
undefined ，那么- 返回 ? target.[[PreventExtensions]]()。
- 让 booleanTrapResult 为
ToBoolean (?Call (trap, handler, « target »))。 - 如果 booleanTrapResult 是
true ，那么- 让 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 extensibleTarget 是
true ，抛出一个TypeError 异常。
- 让 extensibleTarget 为 ?
- 返回 booleanTrapResult。
代理对象的 [[PreventExtensions]] 强制执行以下不变量：
-
[[PreventExtensions]] 的结果
是一个布尔值 。 -
应用于代理对象的 [[PreventExtensions]] 仅在应用于代理对象的目标对象的 [[IsExtensible]] 为
false 时才返回true 。
10.5.5 [[GetOwnProperty]] ( P )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"getOwnPropertyDescriptor" )。 - 如果 trap 是
undefined ，那么- 返回 ? target.[[GetOwnProperty]](P)。
- 让 trapResultObj 为 ?
Call (trap, handler, « target, P »)。 - 如果 trapResultObj
不是一个对象 且 trapResultObj 不是undefined ，抛出一个TypeError 异常。 - 让 targetDesc 为 ? target.[[GetOwnProperty]](P)。
- 如果 trapResultObj 是
undefined ，那么- 如果 targetDesc 是
undefined ，返回undefined 。 - 如果 targetDesc.[[Configurable]] 是
false ，抛出一个TypeError 异常。 - 让 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 extensibleTarget 是
false ，抛出一个TypeError 异常。 - 返回
undefined 。
- 如果 targetDesc 是
- 让 extensibleTarget 为 ?
IsExtensible (target)。 - 让 resultDesc 为 ?
ToPropertyDescriptor (trapResultObj)。 - 执行
CompletePropertyDescriptor (resultDesc)。 - 让 valid 为
IsCompatiblePropertyDescriptor (extensibleTarget, resultDesc, targetDesc)。 - 如果 valid 是
false ，抛出一个TypeError 异常。 - 如果 resultDesc.[[Configurable]] 是
false ，那么- 如果 targetDesc 是
undefined 或 targetDesc.[[Configurable]] 是true ，那么- 抛出一个
TypeError 异常。
- 抛出一个
- 如果 resultDesc 有一个 [[Writable]] 字段且
resultDesc.[[Writable]] 是
false ，那么断言 ：targetDesc 有一个 [[Writable]] 字段。- 如果 targetDesc.[[Writable]] 是
true ，抛出一个TypeError 异常。
- 如果 targetDesc 是
- 返回 resultDesc。
代理对象的 [[GetOwnProperty]] 强制执行以下不变量：
-
[[GetOwnProperty]] 的结果必须是一个对象或
undefined 。 - 如果属性作为目标对象的不可配置自有属性存在，则不能报告该属性不存在。
- 如果属性作为不可扩展目标对象的自有属性存在，则不能报告该属性不存在。
- 如果属性不作为目标对象的自有属性存在且目标对象不可扩展，则不能报告该属性存在。
- 除非属性作为目标对象的不可配置自有属性存在，否则不能报告该属性为不可配置。
- 除非属性作为目标对象的不可配置、不可写自有属性存在，否则不能报告该属性既不可配置又不可写。
10.5.6 [[DefineOwnProperty]] ( P, Desc )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"defineProperty" )。 - 如果 trap 是
undefined ，那么- 返回 ? target.[[DefineOwnProperty]](P, Desc)。
- 让 descObj 为
FromPropertyDescriptor (Desc)。 - 让 booleanTrapResult 为
ToBoolean (?Call (trap, handler, « target, P, descObj »))。 - 如果 booleanTrapResult 是
false ，返回false 。 - 让 targetDesc 为 ? target.[[GetOwnProperty]](P)。
- 让 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 Desc 有一个 [[Configurable]] 字段且
Desc.[[Configurable]] 是
false ，那么- 让 settingConfigFalse 为
true 。
- 让 settingConfigFalse 为
- 否则，
- 让 settingConfigFalse 为
false 。
- 让 settingConfigFalse 为
- 如果 targetDesc 是
undefined ，那么- 如果 extensibleTarget 是
false ，抛出一个TypeError 异常。 - 如果 settingConfigFalse 是
true ，抛出一个TypeError 异常。
- 如果 extensibleTarget 是
- 否则，
- 如果
IsCompatiblePropertyDescriptor (extensibleTarget, Desc, targetDesc) 是false ，抛出一个TypeError 异常。 - 如果 settingConfigFalse 是
true 且 targetDesc.[[Configurable]] 是true ，抛出一个TypeError 异常。 - 如果
IsDataDescriptor (targetDesc) 是true ，targetDesc.[[Configurable]] 是false ，且 targetDesc.[[Writable]] 是true ，那么- 如果 Desc 有一个 [[Writable]] 字段且
Desc.[[Writable]] 是
false ，抛出一个TypeError 异常。
- 如果 Desc 有一个 [[Writable]] 字段且
Desc.[[Writable]] 是
- 如果
- 返回
true 。
10.5.7 [[HasProperty]] ( P )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"has" )。 - 如果 trap 是
undefined ，那么- 返回 ? target.[[HasProperty]](P)。
- 让 booleanTrapResult 为
ToBoolean (?Call (trap, handler, « target, P »))。 - 如果 booleanTrapResult 是
false ，那么- 让 targetDesc 为 ? target.[[GetOwnProperty]](P)。
- 如果 targetDesc 不是
undefined ，那么- 如果 targetDesc.[[Configurable]] 是
false ，抛出一个TypeError 异常。 - 让 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 extensibleTarget 是
false ，抛出一个TypeError 异常。
- 如果 targetDesc.[[Configurable]] 是
- 返回 booleanTrapResult。
代理对象的 [[HasProperty]] 强制执行以下不变量：
-
[[HasProperty]] 的结果
是一个布尔值 。 - 如果属性作为目标对象的不可配置自有属性存在，则不能报告该属性不存在。
- 如果属性作为目标对象的自有属性存在且目标对象不可扩展，则不能报告该属性不存在。
10.5.8 [[Get]] ( P, Receiver )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"get" )。 - 如果 trap 是
undefined ，那么- 返回 ? target.[[Get]](P, Receiver)。
- 让 trapResult 为 ?
Call (trap, handler, « target, P, Receiver »)。 - 让 targetDesc 为 ? target.[[GetOwnProperty]](P)。
- 如果 targetDesc 不是
undefined 且 targetDesc.[[Configurable]] 是false ，那么- 如果
IsDataDescriptor (targetDesc) 是true 且 targetDesc.[[Writable]] 是false ，那么- 如果
SameValue (trapResult, targetDesc.[[Value]]) 是false ，抛出一个TypeError 异常。
- 如果
- 如果
IsAccessorDescriptor (targetDesc) 是true 且 targetDesc.[[Get]] 是undefined ，那么- 如果 trapResult 不是
undefined ，抛出一个TypeError 异常。
- 如果 trapResult 不是
- 如果
- 返回 trapResult。
10.5.9 [[Set]] ( P, V, Receiver )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"set" )。 - 如果 trap 是
undefined ，那么- 返回 ? target.[[Set]](P, V, Receiver)。
- 让 booleanTrapResult 为
ToBoolean (?Call (trap, handler, « target, P, V, Receiver »))。 - 如果 booleanTrapResult 是
false ，返回false 。 - 让 targetDesc 为 ? target.[[GetOwnProperty]](P)。
- 如果 targetDesc 不是
undefined 且 targetDesc.[[Configurable]] 是false ，那么- 如果
IsDataDescriptor (targetDesc) 是true 且 targetDesc.[[Writable]] 是false ，那么- 如果
SameValue (V, targetDesc.[[Value]]) 是false ，抛出一个TypeError 异常。
- 如果
- 如果
IsAccessorDescriptor (targetDesc) 是true ，那么- 如果 targetDesc.[[Set]] 是
undefined ，抛出一个TypeError 异常。
- 如果 targetDesc.[[Set]] 是
- 如果
- 返回
true 。
10.5.10 [[Delete]] ( P )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"deleteProperty" )。 - 如果 trap 是
undefined ，那么- 返回 ? target.[[Delete]](P)。
- 让 booleanTrapResult 为
ToBoolean (?Call (trap, handler, « target, P »))。 - 如果 booleanTrapResult 是
false ，返回false 。 - 让 targetDesc 为 ? target.[[GetOwnProperty]](P)。
- 如果 targetDesc 是
undefined ，返回true 。 - 如果 targetDesc.[[Configurable]] 是
false ，抛出一个TypeError 异常。 - 让 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 extensibleTarget 是
false ，抛出一个TypeError 异常。 - 返回
true 。
代理对象的 [[Delete]] 强制执行以下不变量：
-
[[Delete]] 的结果
是一个布尔值 。 - 如果属性作为目标对象的不可配置自有属性存在，则不能报告该属性被删除。
- 如果属性作为目标对象的自有属性存在且目标对象不可扩展，则不能报告该属性被删除。
10.5.11 [[OwnPropertyKeys]] ( )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"ownKeys" )。 - 如果 trap 是
undefined ，那么- 返回 ? target.[[OwnPropertyKeys]]()。
- 让 trapResultArray 为 ?
Call (trap, handler, « target »)。 - 让 trapResult 为 ?
CreateListFromArrayLike (trapResultArray,property-key )。 - 如果 trapResult 包含任何重复条目，抛出一个
TypeError 异常。 - 让 extensibleTarget 为 ?
IsExtensible (target)。 - 让 targetKeys 为 ? target.[[OwnPropertyKeys]]()。
断言 ： targetKeys 是一个包含属性键 的列表 。断言 ： targetKeys 不包含重复条目。- 让 targetConfigurableKeys 为一个新的空
列表 。 - 让 targetNonconfigurableKeys 为一个新的空
列表 。 - 对 targetKeys 的每个元素 key，执行
- 让 desc 为 ? target.[[GetOwnProperty]](key)。
- 如果 desc 不是
undefined 且 desc.[[Configurable]] 是false ，那么- 将 key 追加到 targetNonconfigurableKeys。
- 否则，
- 将 key 追加到 targetConfigurableKeys。
- 如果 extensibleTarget 是
true 且 targetNonconfigurableKeys 是空的，那么- 返回 trapResult。
- 让 uncheckedResultKeys 为一个
列表 ，其元素是 trapResult 的元素。 - 对 targetNonconfigurableKeys 的每个元素 key，执行
- 如果 uncheckedResultKeys 不包含 key，抛出一个
TypeError 异常。 - 从 uncheckedResultKeys 中移除 key。
- 如果 uncheckedResultKeys 不包含 key，抛出一个
- 如果 extensibleTarget 是
true ，返回 trapResult。 - 对 targetConfigurableKeys 的每个元素 key，执行
- 如果 uncheckedResultKeys 不包含 key，抛出一个
TypeError 异常。 - 从 uncheckedResultKeys 中移除 key。
- 如果 uncheckedResultKeys 不包含 key，抛出一个
- 如果 uncheckedResultKeys 不是空的，抛出一个
TypeError 异常。 - 返回 trapResult。
10.5.12 [[Call]] ( thisArgument, argumentsList )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"apply" )。 - 如果 trap 是
undefined ，那么- 返回 ?
Call (target, thisArgument, argumentsList)。
- 返回 ?
- 让 argArray 为
CreateArrayFromList (argumentsList)。 - 返回 ?
Call (trap, handler, « target, thisArgument, argArray »)。
10.5.13 [[Construct]] ( argumentsList, newTarget )
- 执行 ?
ValidateNonRevokedProxy (O)。 - 让 target 为 O.[[ProxyTarget]]。
断言 ：IsConstructor (target) 是true 。- 让 handler 为 O.[[ProxyHandler]]。
断言 ： handler是一个对象 。- 让 trap 为 ?
GetMethod (handler,"construct" )。 - 如果 trap 是
undefined ，那么- 返回 ?
Construct (target, argumentsList, newTarget)。
- 返回 ?
- 让 argArray 为
CreateArrayFromList (argumentsList)。 - 让 newObj 为 ?
Call (trap, handler, « target, argArray, newTarget »)。 - 如果 newObj
不是一个对象 ，抛出一个TypeError 异常。 - 返回 newObj。
代理对象的 [[Construct]] 强制执行以下不变量：
- [[Construct]] 的结果必须是一个对象。
10.5.14 ValidateNonRevokedProxy ( proxy )
抽象操作 ValidateNonRevokedProxy 接受参数 proxy（一个
- 如果 proxy.[[ProxyTarget]] 是
null ，抛出一个TypeError 异常。 断言 ： proxy.[[ProxyHandler]] 不是null 。- 返回
unused 。
10.5.15 ProxyCreate ( target, handler )
抽象操作 ProxyCreate 接受参数 target（一个
- 如果 target
不是一个对象 ，抛出一个TypeError 异常。 - 如果 handler
不是一个对象 ，抛出一个TypeError 异常。 - 让 P 为
MakeBasicObject (« [[ProxyHandler]], [[ProxyTarget]] »)。 - 将 P 的基本内部方法（除了 [[Call]] 和 [[Construct]]）设置为
10.5 中指定的定义。 - 如果
IsCallable (target) 是true ，那么- 按照
10.5.12 中的指定设置 P.[[Call]]。 - 如果
IsConstructor (target) 是true ，那么- 按照
10.5.13 中的指定设置 P.[[Construct]]。
- 按照
- 按照
- 设置 P.[[ProxyTarget]] 为 target。
- 设置 P.[[ProxyHandler]] 为 handler。
- 返回 P。
11 ECMAScript 语言：源文本
11.1 源文本
语法
ECMAScript 源文本是一个 Unicode 码点序列。所有从 U+0000 到 U+10FFFF 的 Unicode
码点值，包括代理码点，都可以出现在 ECMAScript 语法允许的 ECMAScript 源文本中。用于存储和交换 ECMAScript
源文本的实际编码与本规范无关。无论外部源文本编码如何，符合要求的 ECMAScript 实现都会将源文本处理为等效的
组合字符序列的组成部分被视为单独的 Unicode 码点，即使用户可能认为整个序列是一个字符。
在字符串字面量、正则表达式字面量、模板字面量和标识符中，任何 Unicode 码点也可以使用明确表示码点数值的 Unicode 转义序列来表示。在注释中，这样的转义序列作为注释的一部分被有效忽略。
ECMAScript 在 Unicode 转义序列的行为上与 Java 编程语言不同。在 Java 程序中，如果 Unicode 转义序列 \u000A
出现在单行注释中，它会被解释为行终止符（Unicode 码点 U+000A 是换行符 (LF)），因此下一个码点不是注释的一部分。同样，如果 Unicode 转义序列
\u000A 出现在 Java 程序的字符串字面量中，它同样被解释为行终止符，这在字符串字面量中是不允许的——必须写 \n 而不是
\u000A 来使换行符 (LF) 成为字符串字面量值的一部分。在 ECMAScript 程序中，出现在注释中的 Unicode
转义序列永远不会被解释，因此不能促成注释的终止。同样，出现在 ECMAScript 程序字符串字面量中的 Unicode
转义序列总是对字面量有贡献，永远不会被解释为行终止符或可能终止字符串字面量的码点。
11.1.1 静态语义：UTF16EncodeCodePoint ( cp )
抽象操作 UTF16EncodeCodePoint 接受参数 cp（一个 Unicode 码点）并返回一个字符串。它在被调用时执行以下步骤：
11.1.2 静态语义：CodePointsToString ( text )
抽象操作 CodePointsToString 接受参数 text（一个 Unicode 码点序列）并返回一个字符串。它将 text
转换为字符串值，如
- 令 result 为空字符串。
- 对于 text 的每个码点 cp，执行
- 设置 result 为 result 和
UTF16EncodeCodePoint (cp) 的字符串连接 。
- 设置 result 为 result 和
- 返回 result。
11.1.3 静态语义：UTF16SurrogatePairToCodePoint ( lead, trail )
抽象操作 UTF16SurrogatePairToCodePoint 接受参数 lead（一个码元）和 trail（一个码元）并返回一个码点。形成
UTF-16
11.1.4 静态语义：CodePointAt ( string, position )
抽象操作 CodePointAt 接受参数 string（一个字符串）和 position（一个非负
- 令 size 为 string 的长度。
断言 ： position ≥ 0 且 position < size。- 令 first 为 string 中索引 position 处的码元。
- 令 cp 为数值等于 first 数值的码点。
- 如果 first 既不是
前导代理 也不是后尾代理 ，那么- 返回
记录 { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:false }。
- 返回
- 如果 first 是
后尾代理 或 position + 1 = size，那么- 返回
记录 { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:true }。
- 返回
- 令 second 为 string 中索引 position + 1 处的码元。
- 如果 second 不是
后尾代理 ，那么- 返回
记录 { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:true }。
- 返回
- 设置 cp 为
UTF16SurrogatePairToCodePoint (first, second)。 - 返回
记录 { [[CodePoint]]: cp, [[CodeUnitCount]]: 2, [[IsUnpairedSurrogate]]:false }。
11.1.5 静态语义：StringToCodePoints ( string )
抽象操作 StringToCodePoints 接受参数 string（一个字符串）并返回一个码点的
- 令 codePoints 为一个新的空
列表 。 - 令 size 为 string 的长度。
- 令 position 为 0。
- 重复，当 position < size 时，
- 令 cp 为
CodePointAt (string, position)。 - 将 cp.[[CodePoint]] 追加到 codePoints。
- 设置 position 为 position + cp.[[CodeUnitCount]]。
- 令 cp 为
- 返回 codePoints。
11.1.6 静态语义：ParseText ( sourceText, goalSymbol )
抽象操作 ParseText 接受参数 sourceText（一个字符串或 Unicode 码点序列）和 goalSymbol（ECMAScript
语法中的一个非终结符）并返回一个
- 如果 sourceText
是一个字符串 ，设置 sourceText 为StringToCodePoints (sourceText)。 - 尝试使用 goalSymbol 作为
目标符号 来解析 sourceText，并分析解析结果以查找任何早期错误 条件。解析和早期错误 检测可以以实现定义 的方式交错进行。 - 如果解析成功且未发现
早期错误 ，返回解析产生的解析树根部的解析节点 （goalSymbol 的一个实例）。 - 否则，返回一个包含一个或多个表示解析错误和/或
早期错误 的SyntaxError 对象的列表 。如果存在多个解析错误或早期错误 ，列表中错误对象的数量和顺序是实现定义 的，但至少必须存在一个。
另见第
11.2 源代码类型
ECMAScript 代码有四种类型：
-
全局代码 是被视为 ECMAScript
脚本 的源文本。特定脚本 的全局代码不包括任何被解析为FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 或ClassExpression 一部分的源文本。 -
Eval 代码 是提供给内置
eval函数的源文本。更准确地说，如果内置eval函数的参数是字符串 ，则它被视为 ECMAScript脚本 。特定eval调用的 eval 代码是该脚本 的全局代码部分。 -
函数代码 是被解析以提供 ECMAScript
函数对象 的 [[ECMAScriptCode]] 和 [[FormalParameters]] 内部插槽（参见10.2 ）的值的源文本。特定 ECMAScript 函数的函数代码不包括任何被解析为嵌套的FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 或ClassExpression 的函数代码的源文本。此外，如果上述源文本被解析为：
FunctionDeclaration 或FunctionExpression 的FormalParameters 和FunctionBody ，GeneratorDeclaration 或GeneratorExpression 的FormalParameters 和GeneratorBody ，AsyncFunctionDeclaration 或AsyncFunctionExpression 的FormalParameters 和AsyncFunctionBody ，或AsyncGeneratorDeclaration 或AsyncGeneratorExpression 的FormalParameters 和AsyncGeneratorBody ，
那么，该声明或表达式的
BindingIdentifier （如果有）匹配的源文本 也包含在相应函数的函数代码中。 -
模块代码 是作为
ModuleBody 提供的代码的源文本。它是在模块初始化时直接评估的代码。特定模块的模块代码不包括任何被解析为嵌套的FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 或ClassExpression 一部分的源文本。
将
11.2.1 指令序言和 Use Strict 指令
指令序言是作为
Use Strict 指令
是 "use strict" 或 'use strict'。一个
一个
11.2.2 严格模式代码
ECMAScript 句法单元可以使用非限制性或严格模式语法和语义（
-
如果
全局代码 以包含Use Strict 指令 的指令序言 开头，则它是严格模式代码。 -
模块代码 始终是严格模式代码。 -
ClassDeclaration 或ClassExpression 的所有部分都是严格模式代码。 -
如果
Eval 代码 以包含Use Strict 指令 的指令序言 开头，或者如果对eval的调用是包含在严格模式代码中的直接 eval ，则它是严格模式代码。 -
如果相关的
FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 或AsyncArrowFunction 包含在严格模式代码中，或者如果产生函数 [[ECMAScriptCode]] 内部插槽值的代码以包含Use Strict 指令 的指令序言 开头，则函数代码 是严格模式代码。 -
作为内置 Function、Generator、AsyncFunction 和 AsyncGenerator
构造函数 的参数提供的函数代码 ，如果最后一个参数是字符串 ，并且在处理时是FunctionBody ，该FunctionBody 以包含Use Strict 指令 的指令序言 开头，则它是严格模式代码。
不是严格模式代码的 ECMAScript 代码称为 非严格代码。
11.2.2.1 静态语义：IsStrict ( node )
抽象操作 IsStrict 接受参数 node（一个
11.2.3 非 ECMAScript 函数
ECMAScript 实现可以支持对函数
12 ECMAScript 语言：词法语法
ECMAScript
在某些情况下，词法输入元素的识别对消费输入元素的句法语法上下文很敏感。这需要词法语法具有多个
使用多个词法目标确保不存在会影响自动分号插入的词法歧义。例如，不存在既允许前导除法或除法赋值又允许前导
a = b
/hi/g.exec(c).map(d);其中
a = b / hi / g.exec(c).map(d);语法
12.1 Unicode 格式控制字符
Unicode 格式控制字符（即 Unicode 字符数据库中类别为 "Cf" 的字符，如从左到右标记或从右到左标记）是在缺乏用于此目的的高级协议（如标记语言）的情况下用于控制文本范围格式的控制代码。
允许格式控制字符出现在源文本中是有用的，以便于编辑和显示。所有格式控制字符都可以在注释中以及字符串字面量、模板字面量和正则表达式字面量中使用。
U+FEFF（零宽度无间断空格）是一个格式控制字符，主要用于文本的开头，以将其标记为 Unicode 并允许检测文本的编码和字节顺序。用于此目的的 <ZWNBSP>
字符有时也可能出现在文本开头之后，例如作为连接文件的结果。在
12.2 空白符
空白码点用于改善源文本的可读性并将标记（不可分割的词法单元）彼此分离，但在其他方面是无关紧要的。空白码点可以出现在任意两个标记之间以及输入的开始或结束处。空白码点可以出现在
ECMAScript 空白码点列在
| 码点 | 名称 | 缩写 |
|---|---|---|
U+0009
|
字符制表符 | <TAB> |
U+000B
|
行制表符 | <VT> |
U+000C
|
换页符 (FF) | <FF> |
U+FEFF
|
零宽度无间断空格 | <ZWNBSP> |
| 通用类别 "Space_Separator" 中的任何码点 | <USP> |
U+0020（空格）和 U+00A0（无间断空格）码点是 <USP> 的一部分。
除了
语法
12.3 行终止符
与空白码点一样，行终止符码点用于改善源文本的可读性并将标记（不可分割的词法单元）彼此分离。但是，与空白码点不同，行终止符对句法语法的行为有一定影响。通常，行终止符可以出现在任意两个标记之间，但在句法语法禁止的少数地方则不行。行终止符还会影响自动分号插入的过程（
行终止符可以出现在
行终止符被包含在正则表达式中 \s 类匹配的空白码点集合中。
ECMAScript 行终止符码点列在
| 码点 | Unicode 名称 | 缩写 |
|---|---|---|
U+000A
|
换行符 (LF) | <LF> |
U+000D
|
回车符 (CR) | <CR> |
U+2028
|
行分隔符 | <LS> |
U+2029
|
段分隔符 | <PS> |
只有
语法
12.4 注释
注释可以是单行或多行的。多行注释不能嵌套。
由于单行注释可以包含除 // 标记到行尾的所有码点组成。但是，行尾的
注释的行为类似空白符并被丢弃，除非
语法
本节中的许多产生式在
12.5 Hashbang 注释
Hashbang 注释对位置敏感，与其他类型的注释一样，从句法语法的输入元素流中被丢弃。
语法
12.6 标记
语法
12.7 名称和关键字
本标准规定了特定的码点添加：U+0024（美元符号）和 U+005F（下划线）允许出现在
语法
非终结符
非终结符 _。
具有 Unicode 属性 "ID_Start" 和 "ID_Continue" 的码点集合分别包括具有 Unicode 属性 "Other_ID_Start" 和 "Other_ID_Continue" 的码点。
12.7.1 标识符名称
Unicode 转义序列在 \
不贡献任何码点。\
根据 Unicode 标准规范等价的两个
12.7.1.1 静态语义：早期错误
-
如果
UnicodeEscapeSequence 的IdentifierCodePoint 不是IdentifierStartChar 词法语法产生式匹配的某个 Unicode 码点，则这是语法错误。
-
如果
UnicodeEscapeSequence 的IdentifierCodePoint 不是IdentifierPartChar 词法语法产生式匹配的某个 Unicode 码点，则这是语法错误。
12.7.1.2 静态语义：IdentifierCodePoints
- 设 cp 为
IdentifierStart 的IdentifierCodePoint 。 - 返回 « cp »。
- 设 cps 为派生的
IdentifierName 的IdentifierCodePoints 。 - 设 cp 为
IdentifierPart 的IdentifierCodePoint 。 - 返回 cps 和 « cp » 的
列表连接 。
12.7.1.3 静态语义：IdentifierCodePoint
- 返回
IdentifierStartChar 匹配的码点。
- 返回
IdentifierPartChar 匹配的码点。
- 返回数值等于
Hex4Digits 的 MV 的码点。
- 返回数值等于
CodePoint 的 MV 的码点。
12.7.2 关键字和保留字
关键字是匹配 固定宽度字体直接出现。ECMAScript 的关键字包括
if、while、async、await 等等。
保留字是不能用作标识符的 if
和 while 是保留字。await 只在异步函数和模块内保留。async
不是保留的；它可以无限制地用作变量名或语句标签。
本规范使用语法产生式和 await 和 yield，都是无条件保留的。await 和 yield 的例外在
-
总是允许作为标识符且不是关键字的，如
Math、window、toString和_； -
从不允许作为标识符的，即下面列出的
ReservedWord （除了await和yield）； -
上下文允许作为标识符的，即
await和yield； -
在
严格模式代码 中上下文不允许作为标识符的：let、static、implements、interface、package、private、protected和public； -
总是允许作为标识符，但也在某些句法产生式中作为关键字出现，在不允许
Identifier 的地方：as、async、from、get、meta、of、set和target。
条件关键字或 上下文关键字这个术语有时用来指属于后三个类别的关键字，因此可以在某些上下文中用作标识符，在其他上下文中用作关键字。
语法
根据 \
\ els\u{65} 来声明名为 "else" 的变量。
enum 目前在本规范中未用作关键字。它是一个未来保留字，留作未来语言扩展中用作关键字。
类似地，implements、interface、package、private、protected
和 public 在
12.8 标点符号
语法
12.9 字面量
12.9.1 Null 字面量
语法
12.9.2 布尔字面量
语法
12.9.3 数值字面量
语法
紧跟在
例如：3in 是一个错误，而不是两个输入元素 3 和 in。
12.9.3.1 静态语义：早期错误
- 如果
IsStrict (this production) 是true ，则这是语法错误。
12.9.3.2 静态语义：MV
数值字面量表示
-
DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits DecimalIntegerLiteral 的 MV 加上（DecimalDigits 的 MV × 10-n），其中 n 是DecimalDigits 中的码点数，不包括所有NumericLiteralSeparator 的出现。 -
DecimalLiteral :: DecimalIntegerLiteral . ExponentPart DecimalIntegerLiteral 的 MV × 10e，其中 e 是ExponentPart 的 MV。 -
DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits ExponentPart DecimalIntegerLiteral 的 MV 加上（DecimalDigits 的 MV × 10-n））× 10e，其中 n 是DecimalDigits 中的码点数，不包括所有NumericLiteralSeparator 的出现，e 是ExponentPart 的 MV。 -
DecimalLiteral :: . DecimalDigits DecimalDigits 的 MV × 10-n，其中 n 是DecimalDigits 中的码点数，不包括所有NumericLiteralSeparator 的出现。 -
DecimalLiteral :: . DecimalDigits ExponentPart DecimalDigits 的 MV × 10e - n，其中 n 是DecimalDigits 中的码点数，不包括所有NumericLiteralSeparator 的出现，e 是ExponentPart 的 MV。 -
DecimalLiteral :: DecimalIntegerLiteral ExponentPart DecimalIntegerLiteral 的 MV × 10e，其中 e 是ExponentPart 的 MV。 -
DecimalIntegerLiteral :: 0 -
DecimalIntegerLiteral :: NonZeroDigit NumericLiteralSeparator opt DecimalDigits NonZeroDigit 的 MV × 10n）加上DecimalDigits 的 MV，其中 n 是DecimalDigits 中的码点数，不包括所有NumericLiteralSeparator 的出现。 -
DecimalDigits :: DecimalDigits DecimalDigit DecimalDigits 的 MV × 10）加上DecimalDigit 的 MV。 -
DecimalDigits :: DecimalDigits NumericLiteralSeparator DecimalDigit DecimalDigits 的 MV × 10）加上DecimalDigit 的 MV。 -
ExponentPart :: ExponentIndicator SignedInteger SignedInteger 的 MV。 -
SignedInteger :: - DecimalDigits DecimalDigits 的 MV 的负值。 -
DecimalDigit :: 0 HexDigit :: 0 OctalDigit :: 0 LegacyOctalEscapeSequence :: 0 BinaryDigit :: 0 -
DecimalDigit :: 1 NonZeroDigit :: 1 HexDigit :: 1 OctalDigit :: 1 BinaryDigit :: 1 -
DecimalDigit :: 2 NonZeroDigit :: 2 HexDigit :: 2 OctalDigit :: 2 -
DecimalDigit :: 3 NonZeroDigit :: 3 HexDigit :: 3 OctalDigit :: 3 -
DecimalDigit :: 4 NonZeroDigit :: 4 HexDigit :: 4 OctalDigit :: 4 -
DecimalDigit :: 5 NonZeroDigit :: 5 HexDigit :: 5 OctalDigit :: 5 -
DecimalDigit :: 6 NonZeroDigit :: 6 HexDigit :: 6 OctalDigit :: 6 -
DecimalDigit :: 7 NonZeroDigit :: 7 HexDigit :: 7 OctalDigit :: 7 -
DecimalDigit :: 8 NonZeroDigit :: 8 NonOctalDigit :: 8 HexDigit :: 8 -
DecimalDigit :: 9 NonZeroDigit :: 9 NonOctalDigit :: 9 HexDigit :: 9 -
HexDigit :: a HexDigit :: A -
HexDigit :: b HexDigit :: B -
HexDigit :: c HexDigit :: C -
HexDigit :: d HexDigit :: D -
HexDigit :: e HexDigit :: E -
HexDigit :: f HexDigit :: F -
BinaryDigits :: BinaryDigits BinaryDigit BinaryDigits 的 MV × 2）加上BinaryDigit 的 MV。 -
BinaryDigits :: BinaryDigits NumericLiteralSeparator BinaryDigit BinaryDigits 的 MV × 2）加上BinaryDigit 的 MV。 -
OctalDigits :: OctalDigits OctalDigit OctalDigits 的 MV × 8）加上OctalDigit 的 MV。 -
OctalDigits :: OctalDigits NumericLiteralSeparator OctalDigit OctalDigits 的 MV × 8）加上OctalDigit 的 MV。 -
LegacyOctalIntegerLiteral :: LegacyOctalIntegerLiteral OctalDigit LegacyOctalIntegerLiteral 的 MV × 8）加上OctalDigit 的 MV。 -
NonOctalDecimalIntegerLiteral :: LegacyOctalLikeDecimalIntegerLiteral NonOctalDigit LegacyOctalLikeDecimalIntegerLiteral 的 MV × 10）加上NonOctalDigit 的 MV。 -
NonOctalDecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral DecimalDigit NonOctalDecimalIntegerLiteral 的 MV × 10）加上DecimalDigit 的 MV。 -
LegacyOctalLikeDecimalIntegerLiteral :: LegacyOctalLikeDecimalIntegerLiteral OctalDigit LegacyOctalLikeDecimalIntegerLiteral 的 MV × 10）加上OctalDigit 的 MV。 -
HexDigits :: HexDigits HexDigit HexDigits 的 MV × 16）加上HexDigit 的 MV。 -
HexDigits :: HexDigits NumericLiteralSeparator HexDigit HexDigits 的 MV × 16）加上HexDigit 的 MV。
12.9.3.3 静态语义：NumericValue
- 返回
RoundMVResult (DecimalLiteral 的 MV)。
- 返回
𝔽 (NonDecimalIntegerLiteral 的 MV)。
- 返回
𝔽 (LegacyOctalIntegerLiteral 的 MV)。
- 返回
NonDecimalIntegerLiteral 的 MV 的BigInt 值 。
- 返回
0 ℤ。
- 返回
NonZeroDigit 的 MV 的BigInt 值 。
- 让 n 为
DecimalDigits 中的码点数，不包括所有NumericLiteralSeparator 的出现。 - 让 mv 为（
NonZeroDigit 的 MV × 10n）加上DecimalDigits 的 MV。 - 返回
ℤ (mv)。
12.9.4 字符串字面量
字符串字面量是用单引号或双引号括起来的 0 个或多个 Unicode 码点。Unicode
码点也可以用转义序列表示。除了结束引号码点、U+005C（反斜杠）、U+000D（回车符）和
U+000A（换行符）之外，所有码点都可以直接出现在字符串字面量中。任何码点都可以以转义序列的形式出现。字符串字面量求值为 ECMAScript String 值。生成这些
String 值时，Unicode 码点按照
语法
非终结符
<LF> 和 <CR> 不能出现在字符串字面量中，除非作为 \n 或 \u000A。
12.9.4.1 静态语义：早期错误
- 如果
IsStrict (this production) 是true ，则这是语法错误。
字符串字面量可能出现在将封闭代码置于
function invalid() { "\7"; "use strict"; }12.9.4.2 静态语义：SV
字符串字面量表示
-
StringLiteral :: " " -
StringLiteral :: ' ' -
DoubleStringCharacters :: DoubleStringCharacter DoubleStringCharacters DoubleStringCharacter 的 SV 与DoubleStringCharacters 的 SV 的字符串连接 。 -
SingleStringCharacters :: SingleStringCharacter SingleStringCharacters SingleStringCharacter 的 SV 与SingleStringCharacters 的 SV 的字符串连接 。 -
DoubleStringCharacter :: SourceCharacter but not one of " or\ orLineTerminator SourceCharacter 匹配的码点执行UTF16EncodeCodePoint 的结果。 -
DoubleStringCharacter :: <LS> -
DoubleStringCharacter :: <PS> -
DoubleStringCharacter :: LineContinuation -
SingleStringCharacter :: SourceCharacter but not one of ' or\ orLineTerminator SourceCharacter 匹配的码点执行UTF16EncodeCodePoint 的结果。 -
SingleStringCharacter :: <LS> -
SingleStringCharacter :: <PS> -
SingleStringCharacter :: LineContinuation -
EscapeSequence :: 0 -
CharacterEscapeSequence :: SingleEscapeCharacter 表 37 由SingleEscapeCharacter 确定。
| 转义序列 | 码元值 | Unicode 字符名称 | 符号 |
|---|---|---|---|
\b |
0x0008 |
BACKSPACE | <BS> |
\t |
0x0009 |
CHARACTER TABULATION | <HT> |
\n |
0x000A |
LINE FEED (LF) | <LF> |
\v |
0x000B |
LINE TABULATION | <VT> |
\f |
0x000C |
FORM FEED (FF) | <FF> |
\r |
0x000D |
CARRIAGE RETURN (CR) | <CR> |
\" |
0x0022 |
QUOTATION MARK | " |
\' |
0x0027 |
APOSTROPHE | ' |
\\ |
0x005C |
REVERSE SOLIDUS | \ |
-
NonEscapeCharacter :: SourceCharacter but not one of EscapeCharacter orLineTerminator SourceCharacter 匹配的码点执行UTF16EncodeCodePoint 的结果。 -
EscapeSequence :: LegacyOctalEscapeSequence LegacyOctalEscapeSequence 的 MV。 -
NonOctalDecimalEscapeSequence :: 8 -
NonOctalDecimalEscapeSequence :: 9 -
HexEscapeSequence :: x HexDigit HexDigit HexEscapeSequence 的 MV。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit Hex4Digits 的 MV。 -
UnicodeEscapeSequence :: u{ CodePoint } CodePoint 的 MV 执行UTF16EncodeCodePoint 的结果。 -
TemplateEscapeSequence :: 0
12.9.4.3 静态语义：MV
-
LegacyOctalEscapeSequence :: ZeroToThree OctalDigit ZeroToThree 的 MV × 8）加上OctalDigit 的 MV。 -
LegacyOctalEscapeSequence :: FourToSeven OctalDigit FourToSeven 的 MV × 8）加上OctalDigit 的 MV。 -
LegacyOctalEscapeSequence :: ZeroToThree OctalDigit OctalDigit ZeroToThree 的 MV × 64（即 82））加上（第一个OctalDigit 的 MV × 8）加上第二个OctalDigit 的 MV。 -
ZeroToThree :: 0 -
ZeroToThree :: 1 -
ZeroToThree :: 2 -
ZeroToThree :: 3 -
FourToSeven :: 4 -
FourToSeven :: 5 -
FourToSeven :: 6 -
FourToSeven :: 7 -
HexEscapeSequence :: x HexDigit HexDigit HexDigit 的 MV × 16）加上第二个HexDigit 的 MV。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit HexDigit 的 MV × 0x1000）加上（第二个HexDigit 的 MV × 0x100）加上（第三个HexDigit 的 MV × 0x10）加上第四个HexDigit 的 MV。
12.9.5 正则表达式字面量
下面的产生式描述了正则表达式字面量的语法，并被输入元素扫描器用来找到正则表达式字面量的结尾。包含
实现可以扩展在
语法
正则表达式字面量不能为空；码元序列 //
不是表示空正则表达式字面量，而是开始单行注释。要指定空正则表达式，请使用：/(?:)/。
12.9.5.1 静态语义：BodyText
- 返回被识别为
RegularExpressionBody 的源文本。
12.9.5.2 静态语义：FlagText
- 返回被识别为
RegularExpressionFlags 的源文本。
12.9.6 模板字面量词法组件
语法
12.9.6.1 静态语义：TV
-
NoSubstitutionTemplate :: ` ` -
TemplateHead :: ` ${ -
TemplateMiddle :: } ${ -
TemplateTail :: } ` -
TemplateCharacters :: TemplateCharacter TemplateCharacters TemplateCharacter 的 TV 是undefined 或TemplateCharacters 的 TV 是undefined ，则为undefined 。否则，它是TemplateCharacter 的 TV 与TemplateCharacters 的 TV 的字符串连接 。 -
TemplateCharacter :: SourceCharacter but not one of ` or\ or$ orLineTerminator SourceCharacter 匹配的码点执行UTF16EncodeCodePoint 的结果。 -
TemplateCharacter :: $ -
TemplateCharacter :: \ TemplateEscapeSequence TemplateEscapeSequence 的SV 。 -
TemplateCharacter :: \ NotEscapeSequence undefined 。 -
TemplateCharacter :: LineTerminatorSequence LineTerminatorSequence 的TRV 。 -
LineContinuation :: \ LineTerminatorSequence
12.9.6.2 静态语义：TRV
-
NoSubstitutionTemplate :: ` ` -
TemplateHead :: ` ${ -
TemplateMiddle :: } ${ -
TemplateTail :: } ` -
TemplateCharacters :: TemplateCharacter TemplateCharacters TemplateCharacter 的 TRV 与TemplateCharacters 的 TRV 的字符串连接 。 -
TemplateCharacter :: SourceCharacter but not one of ` or\ or$ orLineTerminator SourceCharacter 匹配的码点执行UTF16EncodeCodePoint 的结果。 -
TemplateCharacter :: $ -
TemplateCharacter :: \ TemplateEscapeSequence TemplateEscapeSequence 的 TRV 的字符串连接 。 -
TemplateCharacter :: \ NotEscapeSequence NotEscapeSequence 的 TRV 的字符串连接 。 -
TemplateEscapeSequence :: 0 -
NotEscapeSequence :: 0 DecimalDigit DecimalDigit 的 TRV 的字符串连接 。 -
NotEscapeSequence :: x [lookahead ∉ HexDigit ] -
NotEscapeSequence :: x HexDigit [lookahead ∉ HexDigit ]HexDigit 的 TRV 的字符串连接 。 -
NotEscapeSequence :: u [lookahead ∉ HexDigit ][lookahead ≠ { ] -
NotEscapeSequence :: u HexDigit [lookahead ∉ HexDigit ]HexDigit 的 TRV 的字符串连接 。 -
NotEscapeSequence :: u HexDigit HexDigit [lookahead ∉ HexDigit ]HexDigit 的 TRV 和第二个HexDigit 的 TRV 的字符串连接 。 -
NotEscapeSequence :: u HexDigit HexDigit HexDigit [lookahead ∉ HexDigit ]HexDigit 的 TRV、第二个HexDigit 的 TRV 和第三个HexDigit 的 TRV 的字符串连接 。 -
NotEscapeSequence :: u { [lookahead ∉ HexDigit ]字符串连接 。 -
NotEscapeSequence :: u { NotCodePoint [lookahead ∉ HexDigit ]NotCodePoint 的 TRV 的字符串连接 。 -
NotEscapeSequence :: u { CodePoint [lookahead ∉ HexDigit ][lookahead ≠ } ]CodePoint 的 TRV 的字符串连接 。 -
DecimalDigit :: one of 0 1 2 3 4 5 6 7 8 9 UTF16EncodeCodePoint 的结果。 -
CharacterEscapeSequence :: NonEscapeCharacter NonEscapeCharacter 的SV 。 -
SingleEscapeCharacter :: one of ' " \ b f n r t v UTF16EncodeCodePoint 的结果。 -
HexEscapeSequence :: x HexDigit HexDigit HexDigit 的 TRV 和第二个HexDigit 的 TRV 的字符串连接 。 -
UnicodeEscapeSequence :: u Hex4Digits Hex4Digits 的 TRV 的字符串连接 。 -
UnicodeEscapeSequence :: u{ CodePoint } CodePoint 的 TRV 和码元 0x007D（右大括号）的字符串连接 。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit HexDigit 的 TRV、第二个HexDigit 的 TRV、第三个HexDigit 的 TRV 和第四个HexDigit 的 TRV 的字符串连接 。 -
HexDigits :: HexDigits HexDigit HexDigits 的 TRV 与HexDigit 的 TRV 的字符串连接 。 -
HexDigit :: one of 0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F UTF16EncodeCodePoint 的结果。 -
LineContinuation :: \ LineTerminatorSequence LineTerminatorSequence 的 TRV 的字符串连接 。 -
LineTerminatorSequence :: <LF> -
LineTerminatorSequence :: <CR> -
LineTerminatorSequence :: <LS> -
LineTerminatorSequence :: <PS> -
LineTerminatorSequence :: <CR> <LF>
12.10 自动分号插入
大多数 ECMAScript 语句和声明必须以分号结尾。这些分号可以始终显式地出现在源文本中。但是，为了方便起见，在某些情况下可以从源文本中省略这些分号。这些情况通过说分号在这些情况下被自动插入到源代码标记流中来描述。
12.10.1 自动分号插入规则
在以下规则中，"标记"是指使用当前词法
分号插入有三个基本规则：
-
当从左到右解析源文本时，遇到语法的任何产生式都不允许的标记（称为违规标记），如果满足以下一个或多个条件，则在违规标记之前自动插入分号：
- 违规标记与前一个标记之间至少有一个
LineTerminator 分隔。 - 违规标记是
}。 - 前一个标记是
)，插入的分号将被解析为 do-while 语句的终止分号（14.7.2 ）。
- 违规标记与前一个标记之间至少有一个
- 当从左到右解析源文本时，遇到标记输入流的结尾，并且解析器无法将输入标记流解析为目标非终结符的单个实例，则在输入流的结尾自动插入分号。
- 当从左到右解析源文本时，遇到语法的某些产生式允许的标记，但该产生式是受限产生式，并且该标记将是紧接着受限产生式中注释"[no
LineTerminator here]"之后的终结符或非终结符的第一个标记（因此这样的标记称为受限标记），并且受限标记与前一个标记之间至少有一个LineTerminator 分隔，则在受限标记之前自动插入分号。
但是，前述规则有一个额外的覆盖条件：如果分号随后会被解析为空语句，或者该分号会成为 for 语句头部中的两个分号之一（参见
以下是语法中唯一的受限产生式：
这些受限产生式的实际效果如下：
- 当遇到
++或--标记时，解析器会将其视为后缀运算符，如果在前一个标记和++或--标记之间至少有一个LineTerminator ，则在++或--标记之前自动插入分号。 - 当遇到
continue、break、return、throw或yield标记，并且在下一个标记之前遇到LineTerminator 时，在continue、break、return、throw或yield标记之后自动插入分号。 - 当箭头函数参数后面在
=>标记之前有LineTerminator 时，自动插入分号，标点符号会导致语法错误。 - 当
async标记后面在function或IdentifierName 或(标记之前有LineTerminator 时，自动插入分号，async标记不被视为与后续标记相同表达式或类元素的一部分。 - 当
async标记后面在*标记之前有LineTerminator 时，自动插入分号，标点符号会导致语法错误。
给 ECMAScript 程序员的实际建议是：
- 后缀
++或--运算符应该与其操作数在同一行。 return或throw语句中的Expression 或yield表达式中的AssignmentExpression 应该与return、throw或yield标记在同一行开始。break或continue语句中的LabelIdentifier 应该与break或continue标记在同一行。- 箭头函数参数的结尾和其
=>应该在同一行。 - 异步函数或方法前面的
async标记应该与紧接着的标记在同一行。
12.10.2 自动分号插入示例
本节是非规范性的。源代码
{ 1 2 } 3不是 ECMAScript 语法中的有效句子，即使有自动分号插入规则。相反，源代码
{ 1
2 } 3也不是有效的 ECMAScript 句子，但通过自动分号插入转换为以下内容：
{ 1
;2 ;} 3;这是一个有效的 ECMAScript 句子。
源代码
for (a; b
)不是有效的 ECMAScript 句子，并且不会被自动分号插入更改，因为 for 语句的头部需要分号。自动分号插入永远不会插入 for
语句头部中的两个分号之一。
源代码
return
a + b通过自动分号插入转换为以下内容：
return;
a + b;表达式 a + b 不被视为 return 语句要返回的值，因为 return 分开。
源代码
a = b
++c通过自动分号插入转换为以下内容：
a = b;
++c;标记 ++ 不被视为应用于变量 b 的后缀运算符，因为 b 和
++ 之间。
源代码
if (a > b)
else c = d不是有效的 ECMAScript 句子，并且不会被自动分号插入在 else 标记之前更改，即使在该点语法的任何产生式都不适用，因为自动插入的分号随后会被解析为空语句。
源代码
a = b + c
(d + e).print()不会被自动分号插入转换，因为第二行开始的括号表达式可以被解释为函数调用的参数列表：
a = b + c(d + e).print()在赋值语句必须以左括号开始的情况下，程序员最好在前一个语句的末尾提供显式分号，而不是依赖自动分号插入。
12.10.3 自动分号插入的有趣情况
本节是非规范性的。ECMAScript 程序可以通过依赖自动分号插入以很少分号的风格编写。如上所述，分号不会在每个换行符处插入，自动分号插入可能依赖于跨行终止符的多个标记。
随着新的语法特性被添加到 ECMAScript 中，可能会添加额外的语法产生式，这些产生式会导致依赖自动分号插入的行在解析时改变语法产生式。
就本节而言，如果自动分号插入的情况是可能插入或不插入分号的地方，取决于其前面的源文本，则被认为是有趣的。本节的其余部分描述了这个版本的 ECMAScript 中自动分号插入的许多有趣情况。
12.10.3.1 语句列表中自动分号插入的有趣情况
在
- 左括号 (
()。没有分号时，两行一起被视为CallExpression 。 - 左方括号 (
[)。没有分号时，两行一起被视为属性访问，而不是ArrayLiteral 或ArrayAssignmentPattern 。 - 模板字面量 (
`)。没有分号时，两行一起被解释为带标签的模板（13.3.11 ），前面的表达式作为MemberExpression 。 - 一元
+或-。没有分号时，两行一起被解释为使用相应二元运算符。 - 正则表达式字面量。没有分号时，两行一起可能被解析为
/MultiplicativeOperator ，例如如果正则表达式有标志。
12.10.3.2 自动分号插入和"[no LineTerminator here]"的情况
本节是非规范性的。
ECMAScript 包含包括"[no
本节的其余部分描述了这个版本的 ECMAScript 中使用"[no
12.10.3.2.1 带有可选操作数和"[no LineTerminator here]"的语法产生式列表
UpdateExpression 。ContinueStatement 。BreakStatement 。ReturnStatement 。YieldExpression 。- 异步函数定义（
15.8 ）与函数定义（15.2 ）的关系
13 ECMAScript 语言：表达式
13.1 标识符
语法
yield 和 await 在语法中被允许作为
let
await 0;13.1.1 静态语义：早期错误
-
如果
IsStrict (this production) 是true 并且Identifier 的StringValue 是"arguments" 或"eval" ，则是语法错误。
-
如果
IsStrict (this production) 是true ，则是语法错误。
- 如果此产生式有 [Yield] 参数，则是语法错误。
- 如果此产生式有 [Await] 参数，则是语法错误。
-
如果此产生式有 [Yield] 参数并且
Identifier 的StringValue 是"yield" ，则是语法错误。 -
如果此产生式有 [Await] 参数并且
Identifier 的StringValue 是"await" ，则是语法错误。
-
如果
IsStrict (this phrase) 是true 并且IdentifierName 的StringValue 是"implements" 、"interface" 、"let" 、"package" 、"private" 、"protected" 、"public" 、"static" 或"yield" 之一，则是语法错误。 -
如果语法语法的
目标符号 是Module 并且IdentifierName 的StringValue 是"await" ，则是语法错误。 -
如果
IdentifierName 的StringValue 与任何ReservedWord 的StringValue 相同（除了yield或await），则是语法错误。
13.1.2 静态语义：StringValue
- 令 idTextUnescaped 为
IdentifierName 的IdentifierCodePoints 。 - 返回
CodePointsToString (idTextUnescaped)。
- 返回
"yield" 。
- 返回
"await" 。
- 返回
IdentifierName 的StringValue 。
- 返回 0x0023（数字符号）与
IdentifierName 的StringValue 的字符串连接 。
- 返回
StringLiteral 的SV 。
13.1.3 运行时语义：Evaluation
- 返回 ?
ResolveBinding (Identifier 的StringValue )。
- 返回 ?
ResolveBinding ("yield" )。
- 返回 ?
ResolveBinding ("await" )。
求值
在yield 可以用作标识符。求值 yield 的绑定，就像它是
13.2 主表达式
语法
补充语法
当处理产生式的实例时
对
13.2.1 this 关键字
13.2.1.1 运行时语义：Evaluation
- 返回 ?
ResolveThisBinding ()。
13.2.2 标识符引用
关于
13.2.3 字面量
语法
13.2.3.1 运行时语义：Evaluation
- 返回
null 。
- 如果
BooleanLiteral 是标记false，返回false 。 - 如果
BooleanLiteral 是标记true，返回true 。
- 返回
NumericLiteral 的NumericValue ，如12.9.3 中定义。
- 返回
StringLiteral 的SV ，如12.9.4.2 中定义。
13.2.4 数组初始化器
数组元素可以在元素列表的开头、中间或末尾省略。当元素列表中的逗号前面没有
语法
13.2.4.1 运行时语义：ArrayAccumulation
- 返回 ?
Elision 与参数 array 和 (nextIndex + 1) 的ArrayAccumulation 。
- 如果
Elision 存在，则- 设置 nextIndex 为 ?
Elision 与参数 array 和 nextIndex 的ArrayAccumulation 。
- 设置 nextIndex 为 ?
- 令 initResult 为 ?
AssignmentExpression 的Evaluation 。 - 令 initValue 为 ?
GetValue (initResult)。 - 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), initValue)。 - 返回 nextIndex + 1。
- 如果
Elision 存在，则- 设置 nextIndex 为 ?
Elision 与参数 array 和 nextIndex 的ArrayAccumulation 。
- 设置 nextIndex 为 ?
- 返回 ?
SpreadElement 与参数 array 和 nextIndex 的ArrayAccumulation 。
- 设置 nextIndex 为 ?
ElementList 与参数 array 和 nextIndex 的ArrayAccumulation 。 - 如果
Elision 存在，则- 设置 nextIndex 为 ?
Elision 与参数 array 和 nextIndex 的ArrayAccumulation 。
- 设置 nextIndex 为 ?
- 令 initResult 为 ?
AssignmentExpression 的Evaluation 。 - 令 initValue 为 ?
GetValue (initResult)。 - 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), initValue)。 - 返回 nextIndex + 1。
- 设置 nextIndex 为 ?
ElementList 与参数 array 和 nextIndex 的ArrayAccumulation 。 - 如果
Elision 存在，则- 设置 nextIndex 为 ?
Elision 与参数 array 和 nextIndex 的ArrayAccumulation 。
- 设置 nextIndex 为 ?
- 返回 ?
SpreadElement 与参数 array 和 nextIndex 的ArrayAccumulation 。
- 令 spreadRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 spreadObj 为 ?
GetValue (spreadRef)。 - 令 iteratorRecord 为 ?
GetIterator (spreadObj,sync )。 - 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，返回 nextIndex。 - 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), next)。 - 设置 nextIndex 为 nextIndex + 1。
- 令 next 为 ?
使用
13.2.4.2 运行时语义：Evaluation
- 令 array 为 !
ArrayCreate (0)。 - 如果
Elision 存在，则- 执行 ?
Elision 与参数 array 和 0 的ArrayAccumulation 。
- 执行 ?
- 返回 array。
- 令 array 为 !
ArrayCreate (0)。 - 执行 ?
ElementList 与参数 array 和 0 的ArrayAccumulation 。 - 返回 array。
- 令 array 为 !
ArrayCreate (0)。 - 令 nextIndex 为 ?
ElementList 与参数 array 和 0 的ArrayAccumulation 。 - 如果
Elision 存在，则- 执行 ?
Elision 与参数 array 和 nextIndex 的ArrayAccumulation 。
- 执行 ?
- 返回 array。
13.2.5 对象初始化器
对象初始化器是一个表达式，描述对象的初始化，以类似字面量的形式编写。它是零个或多个
语法
在某些上下文中，
13.2.5.1 静态语义：早期错误
-
如果
MethodDefinition 的HasDirectSuper 是true ，则是语法错误。 -
如果
MethodDefinition 的PrivateBoundIdentifiers 不为空，则是语法错误。
除了描述实际的对象初始化器之外，
- 如果任何源文本与此产生式匹配，则是语法错误。
此产生式的存在是为了让
-
如果
PropertyDefinitionList 的PropertyNameList 包含任何"__proto__" 的重复条目，并且这些条目中至少有两个是从形式为PropertyDefinition : PropertyName : AssignmentExpression ObjectLiteral 包含在正在为ParseJSON 解析的Script 中（参见ParseJSON 的步骤3 ），则不适用此规则。
13.2.5.2 静态语义：IsComputedPropertyKey
- 返回
false 。
- 返回
true 。
13.2.5.3 静态语义：PropertyNameList
- 令 propName 为
PropertyDefinition 的PropName 。 - 如果 propName 是
empty ，返回新的空列表 。 - 返回 « propName »。
- 令 list 为
PropertyDefinitionList 的PropertyNameList 。 - 令 propName 为
PropertyDefinition 的PropName 。 - 如果 propName 是
empty ，返回 list。 - 返回 list 和 « propName » 的
列表连接 。
13.2.5.4 运行时语义：Evaluation
- 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 ?
PropertyDefinitionList 与参数 obj 的PropertyDefinitionEvaluation 。 - 返回 obj。
- 返回
IdentifierName 的StringValue 。
- 返回
StringLiteral 的SV 。
- 令 nbr 为
NumericLiteral 的NumericValue 。 - 返回 !
ToString (nbr)。
- 令 exprValue 为 ?
AssignmentExpression 的Evaluation 。 - 令 propName 为 ?
GetValue (exprValue)。 - 返回 ?
ToPropertyKey (propName)。
13.2.5.5 运行时语义：PropertyDefinitionEvaluation
- 执行 ?
PropertyDefinitionList 与参数 object 的PropertyDefinitionEvaluation 。 - 执行 ?
PropertyDefinition 与参数 object 的PropertyDefinitionEvaluation 。 - 返回
unused 。
- 令 exprValue 为 ?
AssignmentExpression 的Evaluation 。 - 令 fromValue 为 ?
GetValue (exprValue)。 - 令 excludedNames 为新的空
列表 。 - 执行 ?
CopyDataProperties (object, fromValue, excludedNames)。 - 返回
unused 。
- 令 propName 为
IdentifierReference 的StringValue 。 - 令 exprValue 为 ?
IdentifierReference 的Evaluation 。 - 令 propValue 为 ?
GetValue (exprValue)。 断言 ： object 是一个普通的、可扩展的、没有不可配置属性的对象。- 执行 !
CreateDataPropertyOrThrow (object, propName, propValue)。 - 返回
unused 。
- 令 propKey 为 ?
PropertyName 的Evaluation 。 - 如果此
PropertyDefinition 包含在正在为ParseJSON 求值的Script 中（参见ParseJSON 的步骤6 ），则- 令 isProtoSetter 为
false 。
- 令 isProtoSetter 为
- 否则，如果 propKey 是
"__proto__" 并且PropertyName 的IsComputedPropertyKey 是false ，则- 令 isProtoSetter 为
true 。
- 令 isProtoSetter 为
- 否则，
- 令 isProtoSetter 为
false 。
- 令 isProtoSetter 为
- 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true 并且 isProtoSetter 是false ，则- 令 propValue 为 ?
AssignmentExpression 与参数 propKey 的NamedEvaluation 。
- 令 propValue 为 ?
- 否则，
- 令 exprValueRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 propValue 为 ?
GetValue (exprValueRef)。
- 令 exprValueRef 为 ?
- 如果 isProtoSetter 是
true ，则- 如果 propValue
是对象 或 propValue 是null ，则- 执行 ! object.[[SetPrototypeOf]](propValue)。
- 返回
unused 。
- 如果 propValue
断言 ： object 是一个普通的、可扩展的、没有不可配置属性的对象。- 执行 !
CreateDataPropertyOrThrow (object, propKey, propValue)。 - 返回
unused 。
- 执行 ?
MethodDefinition 与参数 object 和true 的MethodDefinitionEvaluation 。 - 返回
unused 。
13.2.6 函数定义表达式
有关
有关
有关
有关
有关
13.2.7 正则表达式字面量
语法
参见
13.2.7.1 静态语义：早期错误
-
如果
IsValidRegularExpressionLiteral (RegularExpressionLiteral ) 是false ，则是语法错误。
13.2.7.2 静态语义：IsValidRegularExpressionLiteral ( literal )
抽象操作 IsValidRegularExpressionLiteral 接受参数 literal（一个
- 令 flags 为 literal 的
FlagText 。 - 如果 flags 包含除
d、g、i、m、s、u、v或y之外的任何码点，或者如果 flags 包含任何码点超过一次，返回false 。 - 如果 flags 包含
u，令 u 为true ；否则令 u 为false 。 - 如果 flags 包含
v，令 v 为true ；否则令 v 为false 。 - 令 patternText 为 literal 的
BodyText 。 - 如果 u 是
false 且 v 是false ，则- 令 stringValue 为
CodePointsToString (patternText)。 - 设置 patternText 为通过将 stringValue 的每个 16 位元素解释为 Unicode BMP 码点而产生的码点序列。UTF-16 解码不应用于这些元素。
- 令 stringValue 为
- 令 parseResult 为
ParsePattern (patternText, u, v)。 - 如果 parseResult 是
解析节点 ，返回true ；否则返回false 。
13.2.7.3 运行时语义：Evaluation
- 令 pattern 为
CodePointsToString (RegularExpressionLiteral 的BodyText )。 - 令 flags 为
CodePointsToString (RegularExpressionLiteral 的FlagText )。 - 返回 !
RegExpCreate (pattern, flags)。
13.2.8 模板字面量
语法
13.2.8.1 静态语义：早期错误
-
如果 [Tagged] 参数未设置且
NoSubstitutionTemplate 包含 NotEscapeSequence ，则是语法错误。
-
如果
TemplateLiteral 的TemplateStrings 使用参数false 中的元素数量大于或等于 232，则是语法错误。
-
如果 [Tagged] 参数未设置且
TemplateHead 包含 NotEscapeSequence ，则是语法错误。
-
如果 [Tagged] 参数未设置且
TemplateTail 包含 NotEscapeSequence ，则是语法错误。
-
如果 [Tagged] 参数未设置且
TemplateMiddle 包含 NotEscapeSequence ，则是语法错误。
13.2.8.2 静态语义：TemplateStrings
- 返回 «
TemplateString (NoSubstitutionTemplate , raw) »。
- 令 head 为 «
TemplateString (TemplateHead , raw) »。 - 令 tail 为
TemplateSpans 使用参数 raw 的TemplateStrings 。 - 返回 head 和 tail 的
列表连接 。
- 返回 «
TemplateString (TemplateTail , raw) »。
- 令 middle 为
TemplateMiddleList 使用参数 raw 的TemplateStrings 。 - 令 tail 为 «
TemplateString (TemplateTail , raw) »。 - 返回 middle 和 tail 的
列表连接 。
- 返回 «
TemplateString (TemplateMiddle , raw) »。
- 令 front 为
TemplateMiddleList 使用参数 raw 的TemplateStrings 。 - 令 last 为 «
TemplateString (TemplateMiddle , raw) »。 - 返回 front 和 last 的
列表连接 。
13.2.8.3 静态语义：TemplateString ( templateToken, raw )
抽象操作 TemplateString 接受参数 templateToken（一个
如果 raw 是
13.2.8.4 GetTemplateObject ( templateLiteral )
抽象操作 GetTemplateObject 接受参数 templateLiteral（一个
- 令 realm 为
当前领域记录 。 - 令 templateRegistry 为 realm.[[TemplateMap]]。
- 对于 templateRegistry 的每个元素 e，执行
- 如果 e.[[Site]] 与
templateLiteral 是
同一个解析节点 ，则- 返回 e.[[Array]]。
- 如果 e.[[Site]] 与
templateLiteral 是
- 令 rawStrings 为 templateLiteral 使用参数
true 的TemplateStrings 。 断言 ：rawStrings 是字符串的列表 。- 令 cookedStrings 为 templateLiteral 使用参数
false 的TemplateStrings 。 - 令 count 为
列表 cookedStrings 中的元素数量。 断言 ：count ≤ 232 - 1。- 令 template 为 !
ArrayCreate (count)。 - 令 rawObj 为 !
ArrayCreate (count)。 - 令 index 为 0。
- 重复，当 index < count 时，
- 令 prop 为 !
ToString (𝔽 (index))。 - 令 cookedValue 为 cookedStrings[index]。
- 执行 !
DefinePropertyOrThrow (template, prop, PropertyDescriptor { [[Value]]: cookedValue, [[Writable]]:false , [[Enumerable]]:true , [[Configurable]]:false })。 - 令 rawValue 为字符串值 rawStrings[index]。
- 执行 !
DefinePropertyOrThrow (rawObj, prop, PropertyDescriptor { [[Value]]: rawValue, [[Writable]]:false , [[Enumerable]]:true , [[Configurable]]:false })。 - 设置 index 为 index + 1。
- 令 prop 为 !
- 执行 !
SetIntegrityLevel (rawObj,frozen )。 - 执行 !
DefinePropertyOrThrow (template,"raw" , PropertyDescriptor { [[Value]]: rawObj, [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false })。 - 执行 !
SetIntegrityLevel (template,frozen )。 - 将
记录 { [[Site]]: templateLiteral, [[Array]]: template } 附加到 realm.[[TemplateMap]]。 - 返回 template。
模板对象的创建不能导致
本规范的未来版本可能定义模板对象的附加不可枚举属性。
13.2.8.5 运行时语义：SubstitutionEvaluation
- 返回新的空
列表 。
- 令 subRef 为 ?
Expression 的Evaluation 。 - 令 sub 为 ?
GetValue (subRef)。 - 返回 « sub »。
- 令 preceding 为 ?
TemplateMiddleList 的SubstitutionEvaluation 。 - 令 nextRef 为 ?
Expression 的Evaluation 。 - 令 next 为 ?
GetValue (nextRef)。 - 返回 preceding 和 « next » 的
列表连接 。
13.2.8.6 运行时语义：Evaluation
- 返回
NoSubstitutionTemplate 的TV ，如12.9.6 中定义。
- 令 head 为
TemplateHead 的TV ，如12.9.6 中定义。 - 令 subRef 为 ?
Expression 的Evaluation 。 - 令 sub 为 ?
GetValue (subRef)。 - 令 middle 为 ?
ToString (sub)。 - 令 tail 为 ?
TemplateSpans 的Evaluation 。 - 返回 head、middle 和 tail 的
字符串连接 。
应用于 String.prototype.concat 而不是 + 运算符。
- 返回
TemplateTail 的TV ，如12.9.6 中定义。
- 令 head 为 ?
TemplateMiddleList 的Evaluation 。 - 令 tail 为
TemplateTail 的TV ，如12.9.6 中定义。 - 返回 head 和 tail 的
字符串连接 。
- 令 head 为
TemplateMiddle 的TV ，如12.9.6 中定义。 - 令 subRef 为 ?
Expression 的Evaluation 。 - 令 sub 为 ?
GetValue (subRef)。 - 令 middle 为 ?
ToString (sub)。 - 返回 head 和 middle 的
字符串连接 。
应用于 String.prototype.concat 而不是 + 运算符。
- 令 rest 为 ?
TemplateMiddleList 的Evaluation 。 - 令 middle 为
TemplateMiddle 的TV ，如12.9.6 中定义。 - 令 subRef 为 ?
Expression 的Evaluation 。 - 令 sub 为 ?
GetValue (subRef)。 - 令 last 为 ?
ToString (sub)。 - 返回 rest、middle 和 last 的
字符串连接 。
应用于 String.prototype.concat 而不是 + 运算符。
13.2.9 分组运算符
13.2.9.1 静态语义：早期错误
13.2.9.2 运行时语义：Evaluation
- 令 expr 为被
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ParenthesizedExpression 。 - 返回 ? expr 的
Evaluation 。
- 返回 ?
Expression 的Evaluation 。这可能是引用类型。
此算法不对 delete
和 typeof 等运算符可以应用于带括号的表达式。
13.3 左值表达式
语法
补充语法
当处理产生式的实例时
使用以下语法细化对
13.3.1 静态语义
13.3.1.1 静态语义：早期错误
- 如果任何源文本与此产生式匹配，则是语法错误。
此产生式的存在是为了防止自动分号插入规则（
a?.b
`c`这样它就不会被解释为两个有效的语句。目的是与没有可选链的类似代码保持一致：
a.b
`c`这是一个有效的语句，其中不应用自动分号插入。
13.3.2 属性访问器
属性通过名称进行访问，可以使用点记法：
或括号记法：
点记法通过以下语法转换解释：
在行为上等同于
同样地
在行为上等同于
其中 <identifier-name-string> 是
13.3.2.1 运行时语义：Evaluation
- 令 baseReference 为 ?
MemberExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 令 strict 为此
MemberExpression 的IsStrict 。 - 返回 ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict)。
- 令 baseReference 为 ?
MemberExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 令 strict 为此
MemberExpression 的IsStrict 。 - 返回
EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict)。
- 令 baseReference 为 ?
MemberExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 令 fieldNameString 为
PrivateIdentifier 的StringValue 。 - 返回
MakePrivateReference (baseValue, fieldNameString)。
- 令 baseReference 为 ?
CallExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 令 strict 为此
CallExpression 的IsStrict 。 - 返回 ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict)。
- 令 baseReference 为 ?
CallExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 令 strict 为此
CallExpression 的IsStrict 。 - 返回
EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict)。
- 令 baseReference 为 ?
CallExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 令 fieldNameString 为
PrivateIdentifier 的StringValue 。 - 返回
MakePrivateReference (baseValue, fieldNameString)。
13.3.3 EvaluatePropertyAccessWithExpressionKey ( baseValue, expression, strict )
抽象操作 EvaluatePropertyAccessWithExpressionKey 接受参数
baseValue（一个
- 令 propertyNameReference 为 ? expression 的
Evaluation 。 - 令 propertyNameValue 为 ?
GetValue (propertyNameReference)。 - 注：在大多数情况下，
ToPropertyKey 将在此步骤之后立即对 propertyNameValue 执行。但是，在a[b] = c的情况下，它将直到c求值之后才执行。 - 返回
引用记录 { [[Base]]: baseValue, [[ReferencedName]]: propertyNameValue, [[Strict]]: strict, [[ThisValue]]:empty }。
13.3.4 EvaluatePropertyAccessWithIdentifierKey ( baseValue, identifierName, strict )
抽象操作 EvaluatePropertyAccessWithIdentifierKey 接受参数
baseValue（一个
- 令 propertyNameString 为 identifierName 的
StringValue 。 - 返回
引用记录 { [[Base]]: baseValue, [[ReferencedName]]: propertyNameString, [[Strict]]: strict, [[ThisValue]]:empty }。
13.3.5 new 运算符
13.3.5.1 运行时语义：Evaluation
- 返回 ?
EvaluateNew (NewExpression ,empty )。
- 返回 ?
EvaluateNew (MemberExpression ,Arguments )。
13.3.5.1.1 EvaluateNew ( constructExpr, arguments )
抽象操作 EvaluateNew 接受参数 constructExpr（一个
- 令 ref 为 ? constructExpr 的
Evaluation 。 - 令 constructor 为 ?
GetValue (ref)。 - 如果 arguments 是
empty ，则- 令 argList 为新的空
列表 。
- 令 argList 为新的空
- 否则，
- 令 argList 为 ? arguments 的
ArgumentListEvaluation 。
- 令 argList 为 ? arguments 的
- 如果
IsConstructor (constructor) 是false ，抛出TypeError 异常。 - 返回 ?
Construct (constructor, argList)。
13.3.6 函数调用
13.3.6.1 运行时语义：Evaluation
- 令 expr 为被
CoverCallExpressionAndAsyncArrowHead 覆盖 的CallMemberExpression 。 - 令 memberExpr 为 expr 的
MemberExpression 。 - 令 arguments 为 expr 的
Arguments 。 - 令 ref 为 ? memberExpr 的
Evaluation 。 - 令 func 为 ?
GetValue (ref)。 - 如果 ref 是
引用记录 ，IsPropertyReference (ref) 是false ，且 ref.[[ReferencedName]] 是"eval" ，则- 如果
SameValue (func,%eval% ) 是true ，则- 令 argList 为 ? arguments 的
ArgumentListEvaluation 。 - 如果 argList 没有元素，返回
undefined 。 - 令 evalArg 为 argList 的第一个元素。
- 如果此
CallExpression 的IsStrict 是true ，则令 strictCaller 为true 。否则令 strictCaller 为false 。 - 返回
?
PerformEval (evalArg, strictCaller,true )。
- 令 argList 为 ? arguments 的
- 如果
- 令 thisCall 为此
CallExpression 。 - 令 tailCall 为
IsInTailPosition (thisCall)。 - 返回 ?
EvaluateCall (func, ref, arguments, tailCall)。
执行步骤
- 令 ref 为 ?
CallExpression 的Evaluation 。 - 令 func 为 ?
GetValue (ref)。 - 令 thisCall 为此
CallExpression 。 - 令 tailCall 为
IsInTailPosition (thisCall)。 - 返回 ?
EvaluateCall (func, ref,Arguments , tailCall)。
13.3.6.2 EvaluateCall ( func, ref, arguments, tailPosition )
抽象操作 EvaluateCall 接受参数 func（一个
- 如果 ref 是
引用记录 ，则- 如果
IsPropertyReference (ref) 是true ，则- 令 thisValue 为
GetThisValue (ref)。
- 令 thisValue 为
- 否则，
- 如果
- 否则，
- 令 thisValue 为
undefined 。
- 令 thisValue 为
- 令 argList 为 ? arguments 的
ArgumentListEvaluation 。 - 如果 func
不是对象 ，抛出TypeError 异常。 - 如果
IsCallable (func) 是false ，抛出TypeError 异常。 - 如果 tailPosition 是
true ，执行PrepareForTailCall ()。 - 返回 ?
Call (func, thisValue, argList)。
13.3.7 super 关键字
13.3.7.1 运行时语义：Evaluation
- 令 env 为
GetThisEnvironment ()。 - 令 actualThis 为 ? env.GetThisBinding()。
- 令 propertyNameReference 为 ?
Expression 的Evaluation 。 - 令 propertyNameValue 为 ?
GetValue (propertyNameReference)。 - 令 strict 为此
SuperProperty 的IsStrict 。 - 注：在大多数情况下，
ToPropertyKey 将在此步骤之后立即对 propertyNameValue 执行。但是，在super[b] = c的情况下，它将直到c求值之后才执行。 - 返回
MakeSuperPropertyReference (actualThis, propertyNameValue, strict)。
- 令 env 为
GetThisEnvironment ()。 - 令 actualThis 为 ? env.GetThisBinding()。
- 令 propertyKey 为
IdentifierName 的StringValue 。 - 令 strict 为此
SuperProperty 的IsStrict 。 - 返回
MakeSuperPropertyReference (actualThis, propertyKey, strict)。
- 令 newTarget 为
GetNewTarget ()。 断言 ： newTarget 是构造器 。- 令 func 为
GetSuperConstructor ()。 - 令 argList 为 ?
Arguments 的ArgumentListEvaluation 。 - 如果
IsConstructor (func) 是false ，抛出TypeError 异常。 - 令 result 为 ?
Construct (func, argList, newTarget)。 - 令 thisER 为
GetThisEnvironment ()。 断言 ： thisER 是函数环境记录 。- 执行 ?
BindThisValue (thisER, result)。 - 令 F 为 thisER.[[FunctionObject]]。
断言 ： F 是 ECMAScript函数对象 。- 执行 ?
InitializeInstanceElements (result, F)。 - 返回 result。
13.3.7.2 GetSuperConstructor ( )
抽象操作 GetSuperConstructor 不接受参数，返回一个
- 令 envRec 为
GetThisEnvironment ()。 断言 ： envRec 是函数环境记录 。- 令 activeFunction 为 envRec.[[FunctionObject]]。
断言 ： activeFunction 是 ECMAScript函数对象 。- 令 superConstructor 为 ! activeFunction.[[GetPrototypeOf]]()。
- 返回 superConstructor。
13.3.7.3 MakeSuperPropertyReference ( actualThis, propertyKey, strict )
抽象操作 MakeSuperPropertyReference 接受参数 actualThis（一个
- 令 env 为
GetThisEnvironment ()。 断言 ： env.HasSuperBinding() 是true 。断言 ： env 是函数环境记录 。- 令 baseValue 为
GetSuperBase (env)。 - 返回
引用记录 { [[Base]]: baseValue, [[ReferencedName]]: propertyKey, [[Strict]]: strict, [[ThisValue]]: actualThis }。
13.3.8 参数列表
参数列表的求值产生一个值的
13.3.8.1 运行时语义：ArgumentListEvaluation
- 返回新的空
列表 。
- 令 ref 为 ?
AssignmentExpression 的Evaluation 。 - 令 arg 为 ?
GetValue (ref)。 - 返回 « arg »。
- 令 list 为新的空
列表 。 - 令 spreadRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 spreadObj 为 ?
GetValue (spreadRef)。 - 令 iteratorRecord 为 ?
GetIterator (spreadObj,sync )。 - 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，返回 list。 - 将 next 附加到 list。
- 令 next 为 ?
- 令 precedingArgs 为 ?
ArgumentList 的ArgumentListEvaluation 。 - 令 ref 为 ?
AssignmentExpression 的Evaluation 。 - 令 arg 为 ?
GetValue (ref)。 - 返回 precedingArgs 和 « arg » 的
列表连接 。
- 令 precedingArgs 为 ?
ArgumentList 的ArgumentListEvaluation 。 - 令 spreadRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 iteratorRecord 为 ?
GetIterator (?GetValue (spreadRef),sync )。 - 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，返回 precedingArgs。 - 将 next 附加到 precedingArgs。
- 令 next 为 ?
- 令 templateLiteral 为此
TemplateLiteral 。 - 令 siteObj 为
GetTemplateObject (templateLiteral)。 - 返回 « siteObj »。
- 令 templateLiteral 为此
TemplateLiteral 。 - 令 siteObj 为
GetTemplateObject (templateLiteral)。 - 令 remaining 为 ?
SubstitutionTemplate 的ArgumentListEvaluation 。 - 返回 « siteObj » 和 remaining 的
列表连接 。
- 令 firstSubRef 为 ?
Expression 的Evaluation 。 - 令 firstSub 为 ?
GetValue (firstSubRef)。 - 令 restSub 为 ?
TemplateSpans 的SubstitutionEvaluation 。 断言 ： restSub 是可能为空的列表 。- 返回 « firstSub » 和 restSub 的
列表连接 。
13.3.9 可选链
?. 开始。13.3.9.1 运行时语义：Evaluation
- 令 baseReference 为 ?
MemberExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 如果 baseValue 是
undefined 或null ，则- 返回
undefined 。
- 返回
- 返回 ?
OptionalChain 以 baseValue 和 baseReference 为参数的ChainEvaluation 。
- 令 baseReference 为 ?
CallExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 如果 baseValue 是
undefined 或null ，则- 返回
undefined 。
- 返回
- 返回 ?
OptionalChain 以 baseValue 和 baseReference 为参数的ChainEvaluation 。
- 令 baseReference 为 ?
OptionalExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 如果 baseValue 是
undefined 或null ，则- 返回
undefined 。
- 返回
- 返回 ?
OptionalChain 以 baseValue 和 baseReference 为参数的ChainEvaluation 。
13.3.9.2 运行时语义：ChainEvaluation
- 令 thisChain 为此
OptionalChain 。 - 令 tailCall 为
IsInTailPosition (thisChain)。 - 返回 ?
EvaluateCall (baseValue, baseReference,Arguments , tailCall)。
- 令 strict 为此
OptionalChain 的IsStrict 。 - 返回 ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict)。
- 令 strict 为此
OptionalChain 的IsStrict 。 - 返回
EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict)。
- 令 fieldNameString 为
PrivateIdentifier 的StringValue 。 - 返回
MakePrivateReference (baseValue, fieldNameString)。
- 令 optionalChain 为
OptionalChain 。 - 令 newReference 为 ? optionalChain 以 baseValue 和
baseReference 为参数的
ChainEvaluation 。 - 令 newValue 为 ?
GetValue (newReference)。 - 令 thisChain 为此
OptionalChain 。 - 令 tailCall 为
IsInTailPosition (thisChain)。 - 返回 ?
EvaluateCall (newValue, newReference,Arguments , tailCall)。
- 令 optionalChain 为
OptionalChain 。 - 令 newReference 为 ? optionalChain 以 baseValue 和
baseReference 为参数的
ChainEvaluation 。 - 令 newValue 为 ?
GetValue (newReference)。 - 令 strict 为此
OptionalChain 的IsStrict 。 - 返回 ?
EvaluatePropertyAccessWithExpressionKey (newValue,Expression , strict)。
- 令 optionalChain 为
OptionalChain 。 - 令 newReference 为 ? optionalChain 以 baseValue 和
baseReference 为参数的
ChainEvaluation 。 - 令 newValue 为 ?
GetValue (newReference)。 - 令 strict 为此
OptionalChain 的IsStrict 。 - 返回
EvaluatePropertyAccessWithIdentifierKey (newValue,IdentifierName , strict)。
- 令 optionalChain 为
OptionalChain 。 - 令 newReference 为 ? optionalChain 以 baseValue 和
baseReference 为参数的
ChainEvaluation 。 - 令 newValue 为 ?
GetValue (newReference)。 - 令 fieldNameString 为
PrivateIdentifier 的StringValue 。 - 返回
MakePrivateReference (newValue, fieldNameString)。
13.3.10 Import 调用
13.3.10.1 运行时语义：Evaluation
- 返回 ?
EvaluateImportCall (第一个AssignmentExpression , 第二个AssignmentExpression )。
13.3.10.2 EvaluateImportCall ( specifierExpression [ , optionsExpression ] )
抽象操作 EvaluateImportCall 接受参数 specifierExpression（一个
- 令 referrer 为
GetActiveScriptOrModule ()。 - 如果 referrer 是
null ，设置 referrer 为当前 Realm 记录 。 - 令 specifierRef 为 ? specifierExpression 的
Evaluation 。 - 令 specifier 为 ?
GetValue (specifierRef)。 - 如果 optionsExpression 存在，则
- 令 optionsRef 为 ? optionsExpression 的
Evaluation 。 - 令 options 为 ?
GetValue (optionsRef)。
- 令 optionsRef 为 ? optionsExpression 的
- 否则，
- 令 options 为
undefined 。
- 令 options 为
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 specifierString 为
Completion (ToString (specifier))。 IfAbruptRejectPromise (specifierString, promiseCapability)。- 令 attributes 为新的空
列表 。 - 如果 options 不是
undefined ，则- 如果 options
不是对象 ，则- 执行 !
Call (promiseCapability.[[Reject]],undefined , « 新创建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 !
- 令 attributesObj 为
Completion (Get (options,"with" ))。 IfAbruptRejectPromise (attributesObj, promiseCapability)。- 如果 attributesObj 不是
undefined ，则- 如果 attributesObj
不是对象 ，则- 执行 !
Call (promiseCapability.[[Reject]],undefined , « 新创建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 !
- 令 entries 为
Completion (EnumerableOwnProperties (attributesObj,key+value ))。 IfAbruptRejectPromise (entries, promiseCapability)。- 对于 entries 的每个元素 entry，执行
- 如果 attributesObj
- 如果
AllImportAttributesSupported (attributes) 是false ，则- 执行 !
Call (promiseCapability.[[Reject]],undefined , « 新创建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 !
- 按照其 [[Key]] 字段的字典序对 attributes
进行排序，将每个此类字段的值视为 UTF-16 代码单元值的序列。注：此排序仅在禁止
宿主 基于属性枚举的顺序改变行为这一点上是可观察的。
- 如果 options
- 令 moduleRequest 为新的
ModuleRequest 记录 { [[Specifier]]: specifierString, [[Attributes]]: attributes }。 - 执行
HostLoadImportedModule (referrer, moduleRequest,empty , promiseCapability)。 - 返回 promiseCapability.[[Promise]]。
13.3.10.3 ContinueDynamicImport ( promiseCapability, moduleCompletion )
抽象操作 ContinueDynamicImport 接受参数 promiseCapability（一个 import()
- 如果 moduleCompletion 是
突然完成 ，则- 执行 !
Call (promiseCapability.[[Reject]],undefined , « moduleCompletion.[[Value]] »)。 - 返回
unused 。
- 执行 !
- 令 module 为 moduleCompletion.[[Value]]。
- 令 loadPromise 为 module.LoadRequestedModules()。
- 令 rejectedClosure 为新的
抽象闭包 ，参数为 (reason)，捕获 promiseCapability 并在调用时执行以下步骤：- 执行 !
Call (promiseCapability.[[Reject]],undefined , « reason »)。 - 返回
unused 。
- 执行 !
- 令 onRejected 为
CreateBuiltinFunction (rejectedClosure, 1,"" , « »)。 - 令 linkAndEvaluateClosure 为新的
抽象闭包 ，无参数，捕获 module、promiseCapability 和 onRejected 并在调用时执行以下步骤：- 令 link 为
Completion (module.Link())。 - 如果 link 是
突然完成 ，则- 执行 !
Call (promiseCapability.[[Reject]],undefined , « link.[[Value]] »)。 - 返回
unused 。
- 执行 !
- 令 evaluatePromise 为 module.Evaluate()。
- 令 fulfilledClosure 为新的
抽象闭包 ，无参数，捕获 module 和 promiseCapability 并在调用时执行以下步骤：- 令 namespace 为
GetModuleNamespace (module)。 - 执行 ! Call(promiseCapability.[[Resolve]],
undefined , « namespace »)。 - 返回
unused 。
- 令 namespace 为
- 令 onFulfilled 为
CreateBuiltinFunction (fulfilledClosure, 0,"" , « »)。 - 执行
PerformPromiseThen (evaluatePromise, onFulfilled, onRejected)。 - 返回
unused 。
- 令 link 为
- 令 linkAndEvaluate 为
CreateBuiltinFunction (linkAndEvaluateClosure, 0,"" , « »)。 - 执行
PerformPromiseThen (loadPromise, linkAndEvaluate, onRejected)。 - 返回
unused 。
13.3.11 标记模板
标记模板是一个函数调用，其中调用的参数来源于
13.3.11.1 运行时语义：Evaluation
- 令 tagRef 为 ?
MemberExpression 的Evaluation 。 - 令 tagFunc 为 ?
GetValue (tagRef)。 - 令 thisCall 为此
MemberExpression 。 - 令 tailCall 为
IsInTailPosition (thisCall)。 - 返回 ?
EvaluateCall (tagFunc, tagRef,TemplateLiteral , tailCall)。
- 令 tagRef 为 ?
CallExpression 的Evaluation 。 - 令 tagFunc 为 ?
GetValue (tagRef)。 - 令 thisCall 为此
CallExpression 。 - 令 tailCall 为
IsInTailPosition (thisCall)。 - 返回 ?
EvaluateCall (tagFunc, tagRef,TemplateLiteral , tailCall)。
13.3.12 元属性
13.3.12.1 运行时语义：Evaluation
- 返回
GetNewTarget ()。
- 令 module 为
GetActiveScriptOrModule ()。 断言 ： module 是源文本模块记录 。- 令 importMeta 为 module.[[ImportMeta]]。
- 如果 importMeta 是
empty ，则- 设置 importMeta 为
OrdinaryObjectCreate (null )。 - 令 importMetaValues 为
HostGetImportMetaProperties (module)。 - 对于 importMetaValues 的每个
记录 { [[Key]], [[Value]] } p，执行- 执行 !
CreateDataPropertyOrThrow (importMeta, p.[[Key]], p.[[Value]])。
- 执行 !
- 执行
HostFinalizeImportMeta (importMeta, module)。 - 设置 module.[[ImportMeta]] 为 importMeta。
- 返回 importMeta。
- 设置 importMeta 为
- 否则，
13.3.12.1.1 HostGetImportMetaProperties ( moduleRecord )
import.meta 返回的对象提供
HostGetImportMetaProperties 的默认实现是返回新的空
13.3.12.1.2 HostFinalizeImportMeta ( importMeta, moduleRecord )
import.meta 返回的对象。
大多数
HostFinalizeImportMeta 的默认实现是返回
13.4 更新表达式
语法
13.4.1 静态语义：早期错误
-
如果
LeftHandSideExpression 的AssignmentTargetType 不是simple ，这是一个早期语法错误。
-
如果
UnaryExpression 的AssignmentTargetType 不是simple ，这是一个早期语法错误。
13.4.2 后缀递增运算符
13.4.2.1 运行时语义：Evaluation
- 令 lhs 为 ?
LeftHandSideExpression 的Evaluation 。 - 令 oldValue 为 ?
ToNumeric (?GetValue (lhs))。 - 如果 oldValue
是数字 ，则- 令 newValue 为
Number::add (oldValue,1 𝔽)。
- 令 newValue 为
- 否则，
断言 ：oldValue是 BigInt 。- 令 newValue 为
BigInt::add (oldValue,1 ℤ)。
- 执行 ?
PutValue (lhs, newValue)。 - 返回 oldValue。
13.4.3 后缀递减运算符
13.4.3.1 运行时语义：Evaluation
- 令 lhs 为 ?
LeftHandSideExpression 的Evaluation 。 - 令 oldValue 为 ?
ToNumeric (?GetValue (lhs))。 - 如果 oldValue
是数字 ，则- 令 newValue 为
Number::subtract (oldValue,1 𝔽)。
- 令 newValue 为
- 否则，
断言 ：oldValue是 BigInt 。- 令 newValue 为
BigInt::subtract (oldValue,1 ℤ)。
- 执行 ?
PutValue (lhs, newValue)。 - 返回 oldValue。
13.4.4 前缀递增运算符
13.4.4.1 运行时语义：Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 令 oldValue 为 ?
ToNumeric (?GetValue (expr))。 - 如果 oldValue
是数字 ，则- 令 newValue 为
Number::add (oldValue,1 𝔽)。
- 令 newValue 为
- 否则，
断言 ：oldValue是 BigInt 。- 令 newValue 为
BigInt::add (oldValue,1 ℤ)。
- 执行 ?
PutValue (expr, newValue)。 - 返回 newValue。
13.4.5 前缀递减运算符
13.4.5.1 运行时语义：Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 令 oldValue 为 ?
ToNumeric (?GetValue (expr))。 - 如果 oldValue
是数字 ，则- 令 newValue 为
Number::subtract (oldValue,1 𝔽)。
- 令 newValue 为
- 否则，
断言 ：oldValue是 BigInt 。- 令 newValue 为
BigInt::subtract (oldValue,1 ℤ)。
- 执行 ?
PutValue (expr, newValue)。 - 返回 newValue。
13.5 一元运算符
语法
13.5.1 delete 运算符
13.5.1.1 静态语义：早期错误
-
如果
IsStrict (UnaryExpression ) 是true 并且派生的UnaryExpression 是PrimaryExpression : IdentifierReference MemberExpression : MemberExpression . PrivateIdentifier CallExpression : CallExpression . PrivateIdentifier OptionalChain : ?. PrivateIdentifier OptionalChain : OptionalChain . PrivateIdentifier -
如果派生的
UnaryExpression 是
PrimaryExpression : CoverParenthesizedExpressionAndArrowParameterList
并且CoverParenthesizedExpressionAndArrowParameterList 最终派生一个短语，如果用来代替UnaryExpression ，将根据这些规则产生语法错误，这是一个语法错误。此规则递归应用。
最后一条规则意味着如 delete (((foo))) 这样的表达式由于第一条规则的递归应用而产生
13.5.1.2 运行时语义：Evaluation
- 令 ref 为 ?
UnaryExpression 的Evaluation 。 - 如果 ref 不是
引用记录 ，返回true 。 - 如果
IsUnresolvableReference (ref) 是true ，则断言 ：ref.[[Strict]] 是false 。- 返回
true 。
- 如果
IsPropertyReference (ref) 是true ，则断言 ：IsPrivateReference (ref) 是false 。- 如果
IsSuperReference (ref) 是true ，抛出ReferenceError 异常。 - 令 baseObj 为
?
ToObject (ref.[[Base]])。 - 如果 ref.[[ReferencedName]] 不是
属性键 ，则- 设置 ref.[[ReferencedName]] 为
?
ToPropertyKey (ref.[[ReferencedName]])。
- 设置 ref.[[ReferencedName]] 为
?
- 令 deleteStatus 为 ? baseObj.[[Delete]](ref.[[ReferencedName]])。
- 如果 deleteStatus 是
false 并且 ref.[[Strict]] 是true ，抛出TypeError 异常。 - 返回 deleteStatus。
- 否则，
当 delete 运算符出现在delete
运算符出现在
13.5.2 void 运算符
13.5.2.1 运行时语义：Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 执行 ?
GetValue (expr)。 - 返回
undefined 。
即使不使用
13.5.3 typeof 运算符
13.5.3.1 运行时语义：Evaluation
- 令 val 为 ?
UnaryExpression 的Evaluation 。 - 如果 val 是
引用记录 ，则- 如果
IsUnresolvableReference (val) 是true ，返回"undefined" 。
- 如果
- 设置 val 为 ?
GetValue (val)。 - 如果 val 是
undefined ，返回"undefined" 。 - 如果 val 是
null ，返回"object" 。 - 如果 val
是字符串 ，返回"string" 。 - 如果 val
是符号 ，返回"symbol" 。 - 如果 val
是布尔值 ，返回"boolean" 。 - 如果 val
是数字 ，返回"number" 。 - 如果 val
是 BigInt ，返回"bigint" 。 断言 ： val是对象 。- 注：此步骤在
B.3.6.3 节中被替换。 - 如果 val 具有 [[Call]] 内部槽，返回
"function" 。 - 返回
"object" 。
13.5.4 一元 + 运算符
一元 + 运算符将其操作数转换为
13.5.4.1 运行时语义：Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 返回 ?
ToNumber (?GetValue (expr))。
13.5.5 一元 - 运算符
一元 - 运算符将其操作数转换为数值然后对其取反。对
13.5.5.1 运行时语义：Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 令 oldValue 为 ?
ToNumeric (?GetValue (expr))。 - 如果 oldValue
是数字 ，则- 返回
Number::unaryMinus (oldValue)。
- 返回
- 否则，
断言 ：oldValue是 BigInt 。- 返回
BigInt::unaryMinus (oldValue)。
13.5.6 按位非运算符（~）
13.5.6.1 运行时语义：Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 令 oldValue 为 ?
ToNumeric (?GetValue (expr))。 - 如果 oldValue
是数字 ，则- 返回
Number::bitwiseNOT (oldValue)。
- 返回
- 否则，
断言 ：oldValue是 BigInt 。- 返回
BigInt::bitwiseNOT (oldValue)。
13.5.7 逻辑非运算符（!）
13.5.7.1 运行时语义：Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 令 oldValue 为
ToBoolean (?GetValue (expr))。 - 如果 oldValue 是
true ，返回false 。 - 返回
true 。
13.6 幂运算符
语法
13.6.1 运行时语义：Evaluation
13.7 乘法运算符
语法
*运算符执行乘法，产生其操作数的乘积。/运算符执行除法，产生其操作数的商。%运算符产生隐含除法中其操作数的余数。
13.7.1 运行时语义：Evaluation
- 令 opText 为
MultiplicativeOperator 匹配的源文本 。 - 返回 ?
EvaluateStringOrNumericBinaryExpression (MultiplicativeExpression , opText,ExponentiationExpression )。
13.8 加法运算符
语法
13.8.1 加法运算符（+）
加法运算符执行字符串连接或数值加法。
13.8.1.1 运行时语义：Evaluation
13.8.2 减法运算符（-）
- 运算符执行减法，产生其操作数的差。
13.8.2.1 运行时语义：Evaluation
13.9 按位移位运算符
语法
13.9.1 左移运算符（<<）
对左操作数执行按位左移操作，移位量由右操作数指定。
13.9.1.1 运行时语义：Evaluation
13.9.2 有符号右移运算符（>>）
对左操作数执行符号填充的按位右移操作，移位量由右操作数指定。
13.9.2.1 运行时语义：Evaluation
13.9.3 无符号右移运算符（>>>）
对左操作数执行零填充的按位右移操作，移位量由右操作数指定。
13.9.3.1 运行时语义：Evaluation
13.10 关系运算符
关系运算符的求值结果总是布尔类型，反映运算符所命名的关系是否在其两个操作数之间成立。
语法
需要 [In] 语法参数来避免关系表达式中的 in 运算符与 for 语句中的 in
运算符混淆。
13.10.1 运行时语义：Evaluation
- 令 lRef 为 ?
RelationalExpression 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 r 为 ?
IsLessThan (lVal, rVal,true )。 - 如果 r 是
undefined ，返回false 。否则，返回 r。
- 令 lRef 为 ?
RelationalExpression 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 r 为 ?
IsLessThan (rVal, lVal,false )。 - 如果 r 是
undefined ，返回false 。否则，返回 r。
- 令 lRef 为 ?
RelationalExpression 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 r 为 ?
IsLessThan (rVal, lVal,false )。 - 如果 r 是
true 或undefined ，返回false 。否则，返回true 。
- 令 lRef 为 ?
RelationalExpression 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 r 为 ?
IsLessThan (lVal, rVal,true )。 - 如果 r 是
true 或undefined ，返回false 。否则，返回true 。
- 令 lRef 为 ?
RelationalExpression 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 返回 ?
InstanceofOperator (lVal, rVal)。
- 令 lRef 为 ?
RelationalExpression 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 如果 rVal
不是对象 ，抛出TypeError 异常。 - 返回 ?
HasProperty (rVal, ?ToPropertyKey (lVal))。
- 令 privateIdentifier 为
PrivateIdentifier 的StringValue 。 - 令 rRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 如果 rVal
不是对象 ，抛出TypeError 异常。 - 令 privateEnv 为
正在运行的执行上下文 的 PrivateEnvironment。 断言 ： privateEnv 不是null 。- 令 privateName 为
ResolvePrivateIdentifier (privateEnv, privateIdentifier)。 - 如果
PrivateElementFind (rVal, privateName) 不是empty ，返回true 。 - 返回
false 。
13.10.2 InstanceofOperator ( V, target )
抽象操作 InstanceofOperator 接受参数 V（
- 如果 target
不是对象 ，抛出TypeError 异常。 - 令 instOfHandler 为 ?
GetMethod (target,%Symbol.hasInstance% )。 - 如果 instOfHandler 不是
undefined ，则 - 如果
IsCallable (target) 是false ，抛出TypeError 异常。 - 返回 ?
OrdinaryHasInstance (target, V)。
步骤 instanceof 运算符语义。如果对象没有定义或继承 instanceof 语义。
13.11 相等运算符
相等运算符的求值结果总是布尔类型，反映运算符所命名的关系是否在其两个操作数之间成立。
语法
13.11.1 运行时语义：Evaluation
- 令 lRef 为 ?
EqualityExpression 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ?
RelationalExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 返回 ?
IsLooselyEqual (rVal, lVal)。
- 令 lRef 为 ?
EqualityExpression 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ?
RelationalExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 r 为 ?
IsLooselyEqual (rVal, lVal)。 - 如果 r 是
true ，返回false 。否则，返回true 。
- 令 lRef 为 ?
EqualityExpression 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ?
RelationalExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 返回
IsStrictlyEqual (rVal, lVal)。
- 令 lRef 为 ?
EqualityExpression 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ?
RelationalExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 r 为
IsStrictlyEqual (rVal, lVal)。 - 如果 r 是
true ，返回false 。否则，返回true 。
根据上述相等性定义：
-
字符串比较可以通过以下方式强制进行：
`${a}` == `${b}`。 -
数值比较可以通过以下方式强制进行：
+a == +b。 -
布尔比较可以通过以下方式强制进行：
!a == !b。
相等运算符维持以下不变性：
-
A != B等价于!(A == B)。 -
A == B等价于B == A，除了A和B的求值顺序。
相等运算符并不总是传递的。例如，可能有两个不同的 String 对象，每个代表相同的 String 值；每个 String 对象都会被 ==
运算符认为等于 String 值，但两个 String 对象彼此不相等。例如：
-
new String("a") == "a"和"a" == new String("a")都是true 。 -
new String("a") == new String("a")是false 。
字符串的比较使用简单的代码单元值序列相等性测试。没有尝试使用 Unicode 规范中定义的更复杂的、面向语义的字符或字符串相等性和排序定义。因此，根据 Unicode 标准规范相等的字符串值可能测试为不相等。实际上，此算法假设两个字符串都已经是规范化形式。
13.12 二元按位运算符
语法
13.12.1 运行时语义：Evaluation
13.13 二元逻辑运算符
语法
&& 或 || 运算符产生的值不一定是布尔类型。产生的值总是两个操作数表达式之一的值。
13.13.1 运行时语义：Evaluation
- 令 lRef 为 ?
LogicalANDExpression 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 如果
ToBoolean (lVal) 是false ，返回 lVal。 - 令 rRef 为 ?
BitwiseORExpression 的Evaluation 。 - 返回 ?
GetValue (rRef)。
- 令 lRef 为 ?
LogicalORExpression 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 如果
ToBoolean (lVal) 是true ，返回 lVal。 - 令 rRef 为 ?
LogicalANDExpression 的Evaluation 。 - 返回 ?
GetValue (rRef)。
- 令 lRef 为 ?
CoalesceExpressionHead 的Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 如果 lVal 是
undefined 或null ，则- 令 rRef 为 ?
BitwiseORExpression 的Evaluation 。 - 返回 ?
GetValue (rRef)。
- 令 rRef 为 ?
- 否则，
- 返回 lVal。
13.14 条件运算符 ( ? : )
语法
ECMAScript 中
13.14.1 运行时语义：Evaluation
- 令 lRef 为 ?
ShortCircuitExpression 的Evaluation 。 - 令 lVal 为
ToBoolean (?GetValue (lRef))。 - 如果 lVal 是
true ，则- 令 trueRef 为 ? 第一个
AssignmentExpression 的Evaluation 。 - 返回 ?
GetValue (trueRef)。
- 令 trueRef 为 ? 第一个
- 否则，
- 令 falseRef 为 ? 第二个
AssignmentExpression 的Evaluation 。 - 返回 ?
GetValue (falseRef)。
- 令 falseRef 为 ? 第二个
13.15 赋值运算符
语法
13.15.1 静态语义：早期错误
-
如果
LeftHandSideExpression 是ObjectLiteral 或ArrayLiteral ，LeftHandSideExpression 必须覆盖 一个AssignmentPattern 。 -
如果
LeftHandSideExpression 既不是ObjectLiteral 也不是ArrayLiteral ，如果LeftHandSideExpression 的AssignmentTargetType 不是simple ，这是语法错误。
-
如果
LeftHandSideExpression 的AssignmentTargetType 不是simple ，这是语法错误。
13.15.2 运行时语义：Evaluation
- 如果
LeftHandSideExpression 既不是ObjectLiteral 也不是ArrayLiteral ，则- 令 lRef 为 ?
LeftHandSideExpression 的Evaluation 。 - 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true 且LeftHandSideExpression 的IsIdentifierRef 是true ，则- 令 lhs 为
LeftHandSideExpression 的StringValue 。 - 令 rVal 为 ?
AssignmentExpression 以参数 lhs 进行的NamedEvaluation 。
- 令 lhs 为
- 否则，
- 令 rRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。
- 令 rRef 为 ?
- 执行
?
PutValue (lRef, rVal)。 - 返回 rVal。
- 令 lRef 为 ?
- 令 assignmentPattern 为由
LeftHandSideExpression 覆盖 的AssignmentPattern 。 - 令 rRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 执行 ? assignmentPattern 以参数 rVal 进行的
DestructuringAssignmentEvaluation 。 - 返回 rVal。
- 令 lRef 为 ?
LeftHandSideExpression 的Evaluation 。 - 令 lVal 为
?
GetValue (lRef)。 - 令 rRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 assignmentOpText 为
AssignmentOperator 匹配的源代码文本 。 - 令 opText 为下表中与
assignmentOpText 关联的 Unicode 代码点序列：
assignmentOpText opText **=***=*/=/%=%+=+-=-<<=<<>>=>>>>>=>>>&=&^=^|=| - 令 r 为 ?
ApplyStringOrNumericBinaryOperator (lVal, opText, rVal)。 - 执行 ?
PutValue (lRef, r)。 - 返回 r。
- 令 lRef 为 ?
LeftHandSideExpression 的Evaluation 。 - 令 lVal 为
?
GetValue (lRef)。 - 如果
ToBoolean (lVal) 是false ，返回 lVal。 - 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true 且LeftHandSideExpression 的IsIdentifierRef 是true ，则- 令 lhs 为
LeftHandSideExpression 的StringValue 。 - 令 rVal 为 ?
AssignmentExpression 以参数 lhs 进行的NamedEvaluation 。
- 令 lhs 为
- 否则，
- 令 rRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。
- 令 rRef 为 ?
- 执行 ?
PutValue (lRef, rVal)。 - 返回 rVal。
- 令 lRef 为 ?
LeftHandSideExpression 的Evaluation 。 - 令 lVal 为
?
GetValue (lRef)。 - 如果
ToBoolean (lVal) 是true ，返回 lVal。 - 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true 且LeftHandSideExpression 的IsIdentifierRef 是true ，则- 令 lhs 为
LeftHandSideExpression 的StringValue 。 - 令 rVal 为 ?
AssignmentExpression 以参数 lhs 进行的NamedEvaluation 。
- 令 lhs 为
- 否则，
- 令 rRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。
- 令 rRef 为 ?
- 执行 ?
PutValue (lRef, rVal)。 - 返回 rVal。
- 令 lRef 为 ?
LeftHandSideExpression 的Evaluation 。 - 令 lVal 为
?
GetValue (lRef)。 - 如果 lVal 既不是
undefined 也不是null ， 返回 lVal。 - 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true 且LeftHandSideExpression 的IsIdentifierRef 是true ，则- 令 lhs 为
LeftHandSideExpression 的StringValue 。 - 令 rVal 为 ?
AssignmentExpression 以参数 lhs 进行的NamedEvaluation 。
- 令 lhs 为
- 否则，
- 令 rRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。
- 令 rRef 为 ?
- 执行 ?
PutValue (lRef, rVal)。 - 返回 rVal。
13.15.3 ApplyStringOrNumericBinaryOperator ( lVal, opText, rVal )
抽象操作 ApplyStringOrNumericBinaryOperator 接受参数 lVal（一个**、*、/、%、
+、-、<<、>>、
>>>、&、^ 或 |）和
rVal（一个
- 如果 opText 是
+，则- 令 lPrim 为 ?
ToPrimitive (lVal)。 - 令 rPrim 为 ?
ToPrimitive (rVal)。 - 如果 lPrim
是 String 或 rPrim是 String ，则 - 设置 lVal 为 lPrim。
- 设置 rVal 为 rPrim。
- 令 lPrim 为 ?
- 注：此时，这必须是数值运算。
- 令 lNum 为 ?
ToNumeric (lVal)。 - 令 rNum 为 ?
ToNumeric (rVal)。 - 如果
SameType (lNum, rNum) 是false ，抛出TypeError 异常。 - 如果 lNum
是 BigInt ，则- 如果 opText 是
**，返回 ?BigInt::exponentiate (lNum, rNum)。 - 如果 opText 是
/，返回 ?BigInt::divide (lNum, rNum)。 - 如果 opText 是
%，返回 ?BigInt::remainder (lNum, rNum)。 - 如果 opText 是
>>>，返回 ?BigInt::unsignedRightShift (lNum, rNum)。 - 令 operation 为下表中与 opText 关联的抽象操作：
opText operation *BigInt::multiply +BigInt::add -BigInt::subtract <<BigInt::leftShift >>BigInt::signedRightShift &BigInt::bitwiseAND ^BigInt::bitwiseXOR |BigInt::bitwiseOR
- 如果 opText 是
- 否则，
断言 ： lNum是 Number 。- 令 operation 为下表中与 opText 关联的抽象操作：
opText operation **Number::exponentiate *Number::multiply /Number::divide %Number::remainder +Number::add -Number::subtract <<Number::leftShift >>Number::signedRightShift >>>Number::unsignedRightShift &Number::bitwiseAND ^Number::bitwiseXOR |Number::bitwiseOR
- 返回 operation(lNum, rNum)。
在步骤
步骤
13.15.4 EvaluateStringOrNumericBinaryExpression ( leftOperand, opText, rightOperand )
抽象操作 EvaluateStringOrNumericBinaryExpression 接受参数
leftOperand（一个
- 令 lRef 为 ? leftOperand 的
Evaluation 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? rightOperand 的
Evaluation 。 - 令 rVal 为 ?
GetValue (rRef)。 - 返回 ?
ApplyStringOrNumericBinaryOperator (lVal, opText, rVal)。
13.15.5 解构赋值
补充语法
在处理产生式实例的某些情况下
使用以下语法来细化对
13.15.5.1 静态语义：早期错误
-
如果
IdentifierReference 的AssignmentTargetType 不是simple ，这是语法错误。
-
如果
DestructuringAssignmentTarget 是ArrayLiteral 或ObjectLiteral ，这是语法错误。
-
如果
LeftHandSideExpression 是ObjectLiteral 或ArrayLiteral ，LeftHandSideExpression 必须覆盖 一个AssignmentPattern 。 -
如果
LeftHandSideExpression 既不是ObjectLiteral 也不是ArrayLiteral ，如果LeftHandSideExpression 的AssignmentTargetType 不是simple ，这是语法错误。
13.15.5.2 运行时语义：DestructuringAssignmentEvaluation
- 执行 ?
RequireObjectCoercible (value)。 - 返回
unused 。
- 执行 ?
RequireObjectCoercible (value)。 - 执行 ?
AssignmentPropertyList 以参数 value 进行的PropertyDestructuringAssignmentEvaluation 。 - 返回
unused 。
- 执行 ?
RequireObjectCoercible (value)。 - 令 excludedNames 为一个新的空
列表 。 - 返回 ?
AssignmentRestProperty 以参数 value 和 excludedNames 进行的RestDestructuringAssignmentEvaluation 。
- 执行 ?
RequireObjectCoercible (value)。 - 令 excludedNames 为 ?
AssignmentPropertyList 以参数 value 进行的PropertyDestructuringAssignmentEvaluation 。 - 返回 ?
AssignmentRestProperty 以参数 value 和 excludedNames 进行的RestDestructuringAssignmentEvaluation 。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 返回 ?
IteratorClose (iteratorRecord,NormalCompletion (unused ))。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 令 result 为
Completion (Elision 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation )。 - 如果 iteratorRecord.[[Done]] 是
false ，返回 ?IteratorClose (iteratorRecord, result)。 - 返回 result。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 如果存在
Elision ，则- 令 status 为
Completion (Elision 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation )。 - 如果 status 是
异常完成 ，则断言 ： iteratorRecord.[[Done]] 是true 。- 返回 ? status。
- 令 status 为
- 令 result 为
Completion (AssignmentRestElement 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation )。 - 如果 iteratorRecord.[[Done]] 是
false ，返回 ?IteratorClose (iteratorRecord, result)。 - 返回 result。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 令 result 为
Completion (AssignmentElementList 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation )。 - 如果 iteratorRecord.[[Done]] 是
false ，返回 ?IteratorClose (iteratorRecord, result)。 - 返回 result。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 令 status 为
Completion (AssignmentElementList 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation )。 - 如果 status 是
异常完成 ，则- 如果 iteratorRecord.[[Done]] 是
false ，返回 ?IteratorClose (iteratorRecord, status)。 - 返回 ? status。
- 如果 iteratorRecord.[[Done]] 是
- 如果存在
Elision ，则- 设置 status 为
Completion (Elision 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation )。 - 如果 status 是
异常完成 ，则断言 ： iteratorRecord.[[Done]] 是true 。- 返回 ? status。
- 设置 status 为
- 如果存在
AssignmentRestElement ，则- 设置 status 为
Completion (AssignmentRestElement 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation )。
- 设置 status 为
- 如果 iteratorRecord.[[Done]] 是
false ，返回 ?IteratorClose (iteratorRecord, status)。 - 返回 ? status。
13.15.5.3 运行时语义：PropertyDestructuringAssignmentEvaluation
- 令 propertyNames 为 ?
AssignmentPropertyList 以参数 value 进行的PropertyDestructuringAssignmentEvaluation 。 - 令 nextNames 为 ?
AssignmentProperty 以参数 value 进行的PropertyDestructuringAssignmentEvaluation 。 - 返回 propertyNames 和 nextNames 的
列表拼接 。
- 令 P 为
IdentifierReference 的StringValue 。 - 令 lRef 为 ?
ResolveBinding (P)。 - 令 v 为 ?
GetV (value, P)。 - 如果存在
Initializer 且 v 是undefined ，则- 如果
IsAnonymousFunctionDefinition (Initializer ) 是true ，则- 设置 v 为 ?
Initializer 以参数 P 进行的NamedEvaluation 。
- 设置 v 为 ?
- 否则，
- 令 defaultValue 为 ?
Initializer 的Evaluation 。 - 设置 v 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 如果
- 执行 ?
PutValue (lRef, v)。 - 返回 « P »。
- 令 name 为 ?
PropertyName 的Evaluation 。 - 执行 ?
AssignmentElement 以参数 value 和 name 进行的KeyedDestructuringAssignmentEvaluation 。 - 返回 « name »。
13.15.5.4 运行时语义：RestDestructuringAssignmentEvaluation
- 令 lRef 为 ?
DestructuringAssignmentTarget 的Evaluation 。 - 令 restObj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 ?
CopyDataProperties (restObj, value, excludedNames)。 - 返回 ?
PutValue (lRef, restObj)。
13.15.5.5 运行时语义：IteratorDestructuringAssignmentEvaluation
- 返回 ?
AssignmentElisionElement 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation 。
- 执行 ?
AssignmentElementList 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation 。 - 返回 ?
AssignmentElisionElement 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation 。
- 返回 ?
AssignmentElement 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation 。
- 执行 ?
Elision 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation 。 - 返回 ?
AssignmentElement 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation 。
- 如果 iteratorRecord.[[Done]] 是
false ，则- 执行 ?
IteratorStep (iteratorRecord)。
- 执行 ?
- 返回
unused 。
- 执行 ?
Elision 以参数 iteratorRecord 进行的IteratorDestructuringAssignmentEvaluation 。 - 如果 iteratorRecord.[[Done]] 是
false ，则- 执行 ?
IteratorStep (iteratorRecord)。
- 执行 ?
- 返回
unused 。
- 如果
DestructuringAssignmentTarget 既不是ObjectLiteral 也不是ArrayLiteral ，则- 令 lRef 为 ?
DestructuringAssignmentTarget 的Evaluation 。
- 令 lRef 为 ?
- 令 value 为
undefined 。 - 如果 iteratorRecord.[[Done]] 是
false ，则- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 设置 value 为 next。
- 令 next 为 ?
- 如果存在
Initializer 且 value 是undefined ，则- 如果
IsAnonymousFunctionDefinition (Initializer ) 是true 且DestructuringAssignmentTarget 的IsIdentifierRef 是true ，则- 令 target 为
DestructuringAssignmentTarget 的StringValue 。 - 令 v 为 ?
Initializer 以参数 target 进行的NamedEvaluation 。
- 令 target 为
- 否则，
- 令 defaultValue 为 ?
Initializer 的Evaluation 。 - 令 v 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 如果
- 否则，
- 令 v 为 value。
- 如果
DestructuringAssignmentTarget 是ObjectLiteral 或ArrayLiteral ，则- 令 nestedAssignmentPattern 为被
DestructuringAssignmentTarget 覆盖 的AssignmentPattern 。 - 返回 ? nestedAssignmentPattern 以参数 v 进行的
DestructuringAssignmentEvaluation 。
- 令 nestedAssignmentPattern 为被
- 返回 ?
PutValue (lRef, v)。
通过在访问
- 如果
DestructuringAssignmentTarget 既不是ObjectLiteral 也不是ArrayLiteral ，则- 令 lRef 为 ?
DestructuringAssignmentTarget 的Evaluation 。
- 令 lRef 为 ?
- 令 A 为 !
ArrayCreate (0)。 - 令 n 为 0。
- 重复，只要 iteratorRecord.[[Done]] 是
false ，- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), next)。 - 设置 n 为 n + 1。
- 执行 !
- 令 next 为 ?
- 如果
DestructuringAssignmentTarget 既不是ObjectLiteral 也不是ArrayLiteral ，则- 返回 ?
PutValue (lRef, A)。
- 返回 ?
- 令 nestedAssignmentPattern 为被
DestructuringAssignmentTarget 覆盖 的AssignmentPattern 。 - 返回 ? nestedAssignmentPattern 以参数 A 进行的
DestructuringAssignmentEvaluation 。
13.15.5.6 运行时语义：KeyedDestructuringAssignmentEvaluation
- 如果
DestructuringAssignmentTarget 既不是ObjectLiteral 也不是ArrayLiteral ，则- 令 lRef 为 ?
DestructuringAssignmentTarget 的Evaluation 。
- 令 lRef 为 ?
- 令 v 为 ?
GetV (value, propertyName)。 - 如果存在
Initializer 且 v 是undefined ，则- 如果
IsAnonymousFunctionDefinition (Initializer ) 是true 且DestructuringAssignmentTarget 的IsIdentifierRef 是true ，则- 令 target 为
DestructuringAssignmentTarget 的StringValue 。 - 令 rhsValue 为 ?
Initializer 以参数 target 进行的NamedEvaluation 。
- 令 target 为
- 否则，
- 令 defaultValue 为 ?
Initializer 的Evaluation 。 - 令 rhsValue 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 如果
- 否则，
- 令 rhsValue 为 v。
- 如果
DestructuringAssignmentTarget 是ObjectLiteral 或ArrayLiteral ，则- 令 assignmentPattern 为被
DestructuringAssignmentTarget 覆盖 的AssignmentPattern 。 - 返回 ? assignmentPattern 以参数 rhsValue 进行的
DestructuringAssignmentEvaluation 。
- 令 assignmentPattern 为被
- 返回 ?
PutValue (lRef, rhsValue)。
13.16 逗号操作符 ( , )
语法
13.16.1 运行时语义：Evaluation
- 令 lRef 为 ?
Expression 的Evaluation 。 - 执行 ?
GetValue (lRef)。 - 令 rRef 为 ?
AssignmentExpression 的Evaluation 。 - 返回 ?
GetValue (rRef)。
必须调用
14 ECMAScript 语言：语句和声明
语法
14.1 语句语义
14.1.1 运行时语义：Evaluation
- 返回
empty 。
- 返回 ?
FunctionDeclaration 的Evaluation 。
- 令 newLabelSet 为一个新的空
列表 。 - 返回 ? 此
BreakableStatement 以参数 newLabelSet 进行的LabelledEvaluation 。
14.2 块
语法
14.2.1 静态语义：早期错误
-
如果
StatementList 的LexicallyDeclaredNames 包含任何重复条目，则是语法错误。 -
如果
StatementList 的LexicallyDeclaredNames 的任何元素也出现在StatementList 的VarDeclaredNames 中，则是语法错误。
14.2.2 运行时语义：Evaluation
- 返回
empty 。
- 令 oldEnv 为
运行中执行上下文 的 LexicalEnvironment。 - 令 blockEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 执行
BlockDeclarationInstantiation (StatementList , blockEnv)。 - 设置
运行中执行上下文 的 LexicalEnvironment 为 blockEnv。 - 令 blockValue 为
Completion (StatementList 的Evaluation )。 - 设置
运行中执行上下文 的 LexicalEnvironment 为 oldEnv。 - 返回 ? blockValue。
无论控制如何离开
- 令 sl 为 ?
StatementList 的Evaluation 。 - 令 s 为
Completion (StatementListItem 的Evaluation )。 - 返回 ?
UpdateEmpty (s, sl)。
eval 函数的调用都返回值 1：
eval("1;;;;;")
eval("1;{}")
eval("1;var a;")14.2.3 BlockDeclarationInstantiation ( code, env )
抽象操作 BlockDeclarationInstantiation 接受参数 code（一个
调用时执行以下步骤：
- 令 declarations 为 code 的
LexicallyScopedDeclarations 。 - 令 privateEnv 为
运行中执行上下文 的 PrivateEnvironment。 - 对于 declarations 的每个元素 d，执行
- 对于 d 的
BoundNames 的每个元素 dn，执行- 如果 d 的
IsConstantDeclaration 是true ，则- 执行
! env.CreateImmutableBinding(dn,
true )。
- 执行
! env.CreateImmutableBinding(dn,
- 否则，
-
执行
! env.CreateMutableBinding(dn,
false )。注：此步骤在B.3.2.6 节中被替换。
-
执行
! env.CreateMutableBinding(dn,
- 如果 d 的
- 如果 d 是
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration ，则- 令 fn 为 d 的
BoundNames 的唯一元素。 - 令 fo 为 d 以参数 env 和
privateEnv 进行的
InstantiateFunctionObject 。 - 执行
! env.InitializeBinding(fn, fo)。
注：此步骤在
B.3.2.6 节中被替换。
- 令 fn 为 d 的
- 对于 d 的
- 返回
unused 。
14.3 声明和变量语句
14.3.1 Let 和 Const 声明
let 和 const 声明定义的变量作用域限定在let
声明中的
语法
14.3.1.1 静态语义：早期错误
-
如果
BindingList 的BoundNames 包含"let" ，则是语法错误。 -
如果
BindingList 的BoundNames 包含任何重复条目，则是语法错误。
-
如果不存在
Initializer 且包含此LexicalBinding 的LexicalDeclaration 的IsConstantDeclaration 是true ，则是语法错误。
14.3.1.2 运行时语义：Evaluation
- 执行 ?
BindingList 的Evaluation 。 - 返回
empty 。
- 执行 ?
BindingList 的Evaluation 。 - 返回 ?
LexicalBinding 的Evaluation 。
- 令 lhs 为 !
ResolveBinding (BindingIdentifier 的StringValue )。 - 执行 !
InitializeReferencedBinding (lhs,undefined )。 - 返回
empty 。
const 声明中。
- 令 bindingId 为
BindingIdentifier 的StringValue 。 - 令 lhs 为 !
ResolveBinding (bindingId)。 - 如果
IsAnonymousFunctionDefinition (Initializer ) 是true ，则- 令 value 为 ?
Initializer 以参数 bindingId 进行的NamedEvaluation 。
- 令 value 为 ?
- 否则，
- 令 rhs 为 ?
Initializer 的Evaluation 。 - 令 value 为 ?
GetValue (rhs)。
- 令 rhs 为 ?
- 执行 !
InitializeReferencedBinding (lhs, value)。 - 返回
empty 。
- 令 rhs 为 ?
Initializer 的Evaluation 。 - 令 value 为 ?
GetValue (rhs)。 - 令 env 为
运行中执行上下文 的 LexicalEnvironment。 - 返回 ?
BindingPattern 以参数 value 和 env 进行的BindingInitialization 。
14.3.2 变量语句
var 语句声明的变量作用域限定在
语法
14.3.2.1 运行时语义：Evaluation
- 执行 ?
VariableDeclarationList 的Evaluation 。 - 返回
empty 。
- 执行 ?
VariableDeclarationList 的Evaluation 。 - 返回 ?
VariableDeclaration 的Evaluation 。
- 返回
empty 。
- 令 bindingId 为
BindingIdentifier 的StringValue 。 - 令 lhs 为 ?
ResolveBinding (bindingId)。 - 如果
IsAnonymousFunctionDefinition (Initializer ) 是true ，则- 令 value 为 ?
Initializer 以参数 bindingId 进行的NamedEvaluation 。
- 令 value 为 ?
- 否则，
- 令 rhs 为 ?
Initializer 的Evaluation 。 - 令 value 为 ?
GetValue (rhs)。
- 令 rhs 为 ?
- 执行 ?
PutValue (lhs, value)。 - 返回
empty 。
如果
- 令 rhs 为 ?
Initializer 的Evaluation 。 - 令 rVal 为 ?
GetValue (rhs)。 - 返回 ?
BindingPattern 以参数 rVal 和undefined 进行的BindingInitialization 。
14.3.3 解构绑定模式
语法
14.3.3.1 运行时语义：PropertyBindingInitialization
- 令 boundNames 为 ?
BindingPropertyList 以参数 value 和 environment 进行的PropertyBindingInitialization 。 - 令 nextNames 为 ?
BindingProperty 以参数 value 和 environment 进行的PropertyBindingInitialization 。 - 返回 boundNames 和 nextNames 的
列表连接 。
- 令 name 为
SingleNameBinding 的BoundNames 的唯一元素。 - 执行 ?
SingleNameBinding 以参数 value、environment 和 name 进行的KeyedBindingInitialization 。 - 返回 « name »。
- 令 P 为 ?
PropertyName 的Evaluation 。 - 执行 ?
BindingElement 以参数 value、environment 和 P 进行的KeyedBindingInitialization 。 - 返回 « P »。
14.3.3.2 运行时语义：RestBindingInitialization
- 令 lhs 为 ?
ResolveBinding (BindingIdentifier 的StringValue ， environment)。 - 令 restObj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 ?
CopyDataProperties (restObj， value，excludedNames)。 - 如果 environment 是
undefined ，返回 ?PutValue (lhs， restObj)。 - 返回 ?
InitializeReferencedBinding (lhs， restObj)。
14.3.3.3 运行时语义：KeyedBindingInitialization
它在以下产生式上分段定义：
- 令 v 为 ?
GetV (value， propertyName)。 - 如果存在
Initializer 且 v 是undefined ，则- 令 defaultValue 为 ?
Initializer 的Evaluation 。 - 设置 v 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 返回 ?
BindingPattern 以参数 v 和 environment 进行的BindingInitialization 。
- 令 bindingId 为
BindingIdentifier 的StringValue 。 - 令 lhs 为 ?
ResolveBinding (bindingId， environment)。 - 令 v 为 ?
GetV (value， propertyName)。 - 如果存在
Initializer 且 v 是undefined ，则- 如果
IsAnonymousFunctionDefinition (Initializer ) 是true ，则- 设置 v 为 ?
Initializer 以参数 bindingId 进行的NamedEvaluation 。
- 设置 v 为 ?
- 否则，
- 令 defaultValue 为 ?
Initializer 的Evaluation 。 - 设置 v 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 如果
- 如果 environment 是
undefined ，返回 ?PutValue (lhs，v)。 - 返回 ?
InitializeReferencedBinding (lhs， v)。
14.4 空语句
语法
14.4.1 运行时语义：Evaluation
- 返回
empty 。
14.5 表达式语句
语法
function 或 class async function 开头，因为这会与 let [ 开头，因为这会与 let
14.5.1 运行时语义：Evaluation
- 令 exprRef 为 ?
Expression 的Evaluation 。 - 返回 ?
GetValue (exprRef)。
14.6 if 语句
语法
else] 以通常的方式解决了经典的"悬空 else"问题。也就是说，当关联的
if 的选择在其他方面模糊时，else 与候选 if 中最近的（最内层的）关联。
14.6.1 静态语义：早期错误
-
如果
IsLabelledFunction (第一个Statement ) 是true ，则是语法错误。 -
如果
IsLabelledFunction (第二个Statement ) 是true ，则是语法错误。
-
如果
IsLabelledFunction (Statement ) 是true ，则是语法错误。
只有在实现
14.6.2 运行时语义：Evaluation
- 令 exprRef 为 ?
Expression 的Evaluation 。 - 令 exprValue 为
ToBoolean (?GetValue (exprRef))。 - 如果 exprValue 是
true ，则- 令 stmtCompletion 为
Completion (第一个Statement 的Evaluation )。
- 令 stmtCompletion 为
- 否则，
- 令 stmtCompletion 为
Completion (第二个Statement 的Evaluation )。
- 令 stmtCompletion 为
- 返回 ?
UpdateEmpty (stmtCompletion，undefined )。
- 令 exprRef 为 ?
Expression 的Evaluation 。 - 令 exprValue 为
ToBoolean (?GetValue (exprRef))。 - 如果 exprValue 是
false ，则- 返回
undefined 。
- 返回
- 否则，
- 令 stmtCompletion 为
Completion (Statement 的Evaluation )。 - 返回 ?
UpdateEmpty (stmtCompletion，undefined )。
- 令 stmtCompletion 为
14.7 迭代语句
语法
14.7.1 语义
14.7.1.1 LoopContinues ( completion, labelSet )
抽象操作 LoopContinues 接受参数 completion（一个
- 如果 completion 是
正常完成 ，返回true 。 - 如果 completion 不是
continue 完成 ，返回false 。 - 如果 completion.[[Target]] 是
empty ，返回true 。 - 如果 labelSet 包含 completion.[[Target]]，返回
true 。 - 返回
false 。
在
14.7.1.2 运行时语义：LoopEvaluation
- 返回 ?
DoWhileStatement 以参数 labelSet 进行的DoWhileLoopEvaluation 。
- 返回 ?
WhileStatement 以参数 labelSet 进行的WhileLoopEvaluation 。
- 返回 ?
ForStatement 以参数 labelSet 进行的ForLoopEvaluation 。
- 返回 ?
ForInOfStatement 以参数 labelSet 进行的ForInOfLoopEvaluation 。
14.7.2 do-while 语句
语法
14.7.2.1 静态语义：早期错误
-
如果
IsLabelledFunction (Statement ) 是true ，则是语法错误。
只有在实现
14.7.2.2 运行时语义：DoWhileLoopEvaluation
- 令 V 为
undefined 。 - 重复，
- 令 stmtResult 为
Completion (Statement 的Evaluation )。 - 如果
LoopContinues (stmtResult， labelSet) 是false ，返回 ?UpdateEmpty (stmtResult， V)。 - 如果 stmtResult.[[Value]] 不是
empty ，设置 V 为 stmtResult.[[Value]]。 - 令 exprRef 为 ?
Expression 的Evaluation 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 如果
ToBoolean (exprValue) 是false ，返回 V。
- 令 stmtResult 为
14.7.3 while 语句
语法
14.7.3.1 静态语义：早期错误
-
如果
IsLabelledFunction (Statement ) 是true ，则是语法错误。
只有在实现
14.7.3.2 运行时语义：WhileLoopEvaluation
- 令 V 为
undefined 。 - 重复，
- 令 exprRef 为 ?
Expression 的Evaluation 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 如果
ToBoolean (exprValue) 是false ，返回 V。 - 令 stmtResult 为
Completion (Statement 的Evaluation )。 - 如果
LoopContinues (stmtResult， labelSet) 是false ，返回 ?UpdateEmpty (stmtResult， V)。 - 如果 stmtResult.[[Value]] 不是
empty ，设置 V 为 stmtResult.[[Value]]。
- 令 exprRef 为 ?
14.7.4 for 语句
语法
14.7.4.1 静态语义：早期错误
-
如果
IsLabelledFunction (Statement ) 是true ，则是语法错误。
只有在实现
-
如果
LexicalDeclaration 的BoundNames 的任何元素也出现在Statement 的VarDeclaredNames 中，则是语法错误。
14.7.4.2 运行时语义：ForLoopEvaluation
- 如果第一个
Expression 存在，则- 令 exprRef 为 ? 第一个
Expression 的Evaluation 。 - 执行 ?
GetValue (exprRef)。
- 令 exprRef 为 ? 第一个
- 如果第二个
Expression 存在，令 test 为第二个Expression ；否则，令 test 为empty 。 - 如果第三个
Expression 存在，令 increment 为第三个Expression ；否则，令 increment 为empty 。 - 返回 ?
ForBodyEvaluation (test， increment，Statement ，« »， labelSet)。
- 执行 ?
VariableDeclarationList 的Evaluation 。 - 如果第一个
Expression 存在，令 test 为第一个Expression ；否则，令 test 为empty 。 - 如果第二个
Expression 存在，令 increment 为第二个Expression ；否则，令 increment 为empty 。 - 返回 ?
ForBodyEvaluation (test， increment，Statement ，« »， labelSet)。
- 令 oldEnv 为
运行中执行上下文 的 LexicalEnvironment。 - 令 loopEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 令 isConst 为
LexicalDeclaration 的IsConstantDeclaration 。 - 令 boundNames 为
LexicalDeclaration 的BoundNames 。 - 对 boundNames 的每个元素 dn，执行
- 如果 isConst 是
true ，则- 执行
! loopEnv.CreateImmutableBinding(dn，
true )。
- 执行
! loopEnv.CreateImmutableBinding(dn，
- 否则，
- 执行
! loopEnv.CreateMutableBinding(dn，
false )。
- 执行
! loopEnv.CreateMutableBinding(dn，
- 如果 isConst 是
- 设置
运行中执行上下文 的 LexicalEnvironment 为 loopEnv。 - 令 forDcl 为
Completion (LexicalDeclaration 的Evaluation )。 - 如果 forDcl 是
突然完成 ，则- 设置
运行中执行上下文 的 LexicalEnvironment 为 oldEnv。 - 返回 ? forDcl。
- 设置
- 如果 isConst 是
false ，令 perIterationLets 为 boundNames；否则令 perIterationLets 为新的空列表 。 - 如果第一个
Expression 存在，令 test 为第一个Expression ；否则，令 test 为empty 。 - 如果第二个
Expression 存在，令 increment 为第二个Expression ；否则，令 increment 为empty 。 - 令 bodyResult 为
Completion (ForBodyEvaluation (test， increment，Statement ，perIterationLets， labelSet))。 - 设置
运行中执行上下文 的 LexicalEnvironment 为 oldEnv。 - 返回 ? bodyResult。
14.7.4.3 ForBodyEvaluation ( test, increment, stmt, perIterationBindings, labelSet )
抽象操作 ForBodyEvaluation 接受参数 test（一个
- 令 V 为
undefined 。 - 执行 ?
CreatePerIterationEnvironment (perIterationBindings)。 - 重复，
- 如果 test 不是
empty ，则- 令 testRef 为 ? test 的
Evaluation 。 - 令 testValue 为 ?
GetValue (testRef)。 - 如果
ToBoolean (testValue) 是false ，返回 V。
- 令 testRef 为 ? test 的
- 令 result 为
Completion (stmt 的Evaluation )。 - 如果
LoopContinues (result， labelSet) 是false ，返回 ?UpdateEmpty (result， V)。 - 如果 result.[[Value]] 不是
empty ，设置 V 为 result.[[Value]]。 - 执行 ?
CreatePerIterationEnvironment (perIterationBindings)。 - 如果 increment 不是
empty ，则- 令 incRef 为 ? increment 的
Evaluation 。 - 执行 ?
GetValue (incRef)。
- 令 incRef 为 ? increment 的
- 如果 test 不是
14.7.4.4 CreatePerIterationEnvironment ( perIterationBindings )
抽象操作 CreatePerIterationEnvironment 接受参数
perIterationBindings（一个
- 如果 perIterationBindings 有任何元素，则
- 令 lastIterationEnv 为
运行中执行上下文 的 LexicalEnvironment。 - 令 outer 为 lastIterationEnv.[[OuterEnv]]。
断言 ：outer 不是null 。- 令 thisIterationEnv 为
NewDeclarativeEnvironment (outer)。 - 对 perIterationBindings 的每个元素 bn，执行
- 执行
! thisIterationEnv.CreateMutableBinding(bn，
false )。 - 令 lastValue 为
? lastIterationEnv.GetBindingValue(bn，
true )。 - 执行 ! thisIterationEnv.InitializeBinding(bn， lastValue)。
- 执行
! thisIterationEnv.CreateMutableBinding(bn，
- 设置
运行中执行上下文 的 LexicalEnvironment 为 thisIterationEnv。
- 令 lastIterationEnv 为
- 返回
unused 。
14.7.5 for-in、
for-of 和 for-await-of
语句
语法
本节由附录
14.7.5.1 静态语义：早期错误
-
如果
IsLabelledFunction (Statement ) 是true ，则是语法错误。
只有在实现
-
如果
LeftHandSideExpression 是ObjectLiteral 或ArrayLiteral ，那么LeftHandSideExpression 必须覆盖 AssignmentPattern 。 -
如果
LeftHandSideExpression 既不是ObjectLiteral 也不是ArrayLiteral ，如果LeftHandSideExpression 的AssignmentTargetType 不是simple ，则是语法错误。
-
如果
ForDeclaration 的BoundNames 包含"let" ，则是语法错误。 -
如果
ForDeclaration 的BoundNames 的任何元素也出现在Statement 的VarDeclaredNames 中，则是语法错误。 -
如果
ForDeclaration 的BoundNames 包含 任何重复条目，则是语法错误。
14.7.5.2 静态语义：IsDestructuring
- 如果
PrimaryExpression 是ObjectLiteral 或ArrayLiteral ， 返回true 。 - 返回
false 。
- 返回
false 。
- 返回
ForBinding 的IsDestructuring 。
- 返回
false 。
- 返回
true 。
本节由附录
14.7.5.3 运行时语义：ForDeclarationBindingInitialization
它在以下产生式上分段定义：
- 返回 ?
ForBinding 以参数 value 和 environment 进行的BindingInitialization 。
14.7.5.4 运行时语义：ForDeclarationBindingInstantiation
- 对
ForBinding 的BoundNames 的每个元素 name，执行- 如果
LetOrConst 的IsConstantDeclaration 是true ，则- 执行
! environment.CreateImmutableBinding(name，
true )。
- 执行
! environment.CreateImmutableBinding(name，
- 否则，
- 执行
! environment.CreateMutableBinding(name，
false )。
- 执行
! environment.CreateMutableBinding(name，
- 如果
- 返回
unused 。
14.7.5.5 运行时语义：ForInOfLoopEvaluation
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,Expression ,enumerate )。 - 返回 ?
ForIn/OfBodyEvaluation (LeftHandSideExpression ,Statement , keyResult,enumerate ,assignment , labelSet)。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,Expression ,enumerate )。 - 返回 ?
ForIn/OfBodyEvaluation (ForBinding ,Statement , keyResult,enumerate ,var-binding , labelSet)。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (ForDeclaration 的BoundNames ,Expression ,enumerate )。 - 返回 ?
ForIn/OfBodyEvaluation (ForDeclaration ,Statement , keyResult,enumerate ,lexical-binding , labelSet)。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,iterate )。 - 返回 ?
ForIn/OfBodyEvaluation (LeftHandSideExpression ,Statement , keyResult,iterate ,assignment , labelSet)。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,iterate )。 - 返回 ?
ForIn/OfBodyEvaluation (ForBinding ,Statement , keyResult,iterate ,var-binding , labelSet)。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (ForDeclaration 的BoundNames ,AssignmentExpression ,iterate )。 - 返回 ?
ForIn/OfBodyEvaluation (ForDeclaration ,Statement , keyResult,iterate ,lexical-binding , labelSet)。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,async-iterate )。 - 返回 ?
ForIn/OfBodyEvaluation (LeftHandSideExpression ,Statement , keyResult,iterate ,assignment , labelSet,async )。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,async-iterate )。 - 返回 ?
ForIn/OfBodyEvaluation (ForBinding ,Statement , keyResult,iterate ,var-binding , labelSet,async )。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (ForDeclaration 的BoundNames ,AssignmentExpression ,async-iterate )。 - 返回 ?
ForIn/OfBodyEvaluation (ForDeclaration ,Statement , keyResult,iterate ,lexical-binding , labelSet,async )。
本节由附录
14.7.5.6 ForIn/OfHeadEvaluation ( uninitializedBoundNames, expr, iterationKind )
抽象操作 ForIn/OfHeadEvaluation 接受参数
uninitializedBoundNames（一个包含字符串的
- 令 oldEnv 为
运行执行上下文 的 LexicalEnvironment。 - 如果 uninitializedBoundNames 不为空，则
断言 ： uninitializedBoundNames 没有重复的条目。- 令 newEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 对 uninitializedBoundNames 的每个字符串 name，执行
- 执行
! newEnv.CreateMutableBinding(name,
false )。
- 执行
! newEnv.CreateMutableBinding(name,
- 设置
运行执行上下文 的 LexicalEnvironment 为 newEnv。
- 令 exprRef 为
Completion (Evaluation of expr)。 - 设置
运行执行上下文 的 LexicalEnvironment 为 oldEnv。 - 令 exprValue 为 ?
GetValue (? exprRef)。 - 如果 iterationKind 是
enumerate ，则- 如果 exprValue 是
undefined 或null ，则- 返回
完成记录 { [[Type]]:break , [[Value]]:empty , [[Target]]:empty }。
- 返回
- 令 obj 为 !
ToObject (exprValue)。 - 令 iterator 为
EnumerateObjectProperties (obj)。 - 令 nextMethod 为 !
GetV (iterator,"next" )。 - 返回
迭代器记录 { [[Iterator]]: iterator, [[NextMethod]]: nextMethod, [[Done]]:false }。
- 如果 exprValue 是
- 否则，
断言 ： iterationKind 是iterate 或async-iterate 。- 如果 iterationKind 是
async-iterate ，令 iteratorKind 为async 。 - 否则，令 iteratorKind 为
sync 。 - 返回 ?
GetIterator (exprValue, iteratorKind)。
14.7.5.7 ForIn/OfBodyEvaluation ( lhs, stmt, iteratorRecord, iterationKind, lhsKind, labelSet [ , iteratorKind ] )
抽象操作 ForIn/OfBodyEvaluation 接受参数 lhs（一个
- 如果 iteratorKind 不存在，设置 iteratorKind 为
sync 。 - 令 oldEnv 为
运行执行上下文 的 LexicalEnvironment。 - 令 V 为
undefined 。 - 令 destructuring 为 lhs 的
IsDestructuring 。 - 如果 destructuring 是
true 且 lhsKind 是assignment ，则断言 ： lhs 是一个LeftHandSideExpression 。- 令 assignmentPattern 为被 lhs
覆盖 的AssignmentPattern 。
- 重复，
- 令 nextResult 为 ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])。 - 如果 iteratorKind 是
async ，设置 nextResult 为 ?Await (nextResult)。 - 如果 nextResult
不是对象 ，抛出TypeError 异常。 - 令 done 为 ?
IteratorComplete (nextResult)。 - 如果 done 是
true ，返回 V。 - 令 nextValue 为 ?
IteratorValue (nextResult)。 - 如果 lhsKind 是
assignment 或var-binding ，则- 如果 destructuring 是
true ，则- 如果 lhsKind 是
assignment ， 则- 令 status 为
Completion (以参数 nextValue 对 assignmentPattern 进行的DestructuringAssignmentEvaluation )。
- 令 status 为
- 否则，
断言 ： lhsKind 是var-binding 。断言 ： lhs 是一个ForBinding 。- 令 status 为
Completion (以参数 nextValue 和undefined 对 lhs 进行的BindingInitialization )。
- 如果 lhsKind 是
- 否则，
- 令 lhsRef 为
Completion (Evaluation of lhs)。（它可能被重复求值。） - 如果 lhsRef 是
突然完成 ，则- 令 status 为 lhsRef。
- 否则，
- 令 status 为
Completion (PutValue (lhsRef.[[Value]], nextValue))。
- 令 status 为
- 令 lhsRef 为
- 如果 destructuring 是
- 否则，
断言 ：lhsKind 是lexical-binding 。断言 ：lhs 是一个ForDeclaration 。- 令 iterationEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 以参数 iterationEnv 对 lhs 执行
ForDeclarationBindingInstantiation 。 - 设置
运行执行上下文 的 LexicalEnvironment 为 iterationEnv。 - 如果 destructuring 是
true ，则- 令 status 为
Completion (以参数 nextValue 和 iterationEnv 对 lhs 进行的ForDeclarationBindingInitialization )。
- 令 status 为
- 否则，
断言 ：lhs 绑定单个名称。- 令 lhsName 为 lhs 的
BoundNames 的唯一元素。 - 令 lhsRef 为 !
ResolveBinding (lhsName)。 - 令 status 为
Completion (InitializeReferencedBinding (lhsRef, nextValue))。
- 如果 status 是
突然完成 ，则- 设置
运行执行上下文 的 LexicalEnvironment 为 oldEnv。 - 如果 iteratorKind 是
async ，返回 ?AsyncIteratorClose (iteratorRecord, status)。 - 如果 iterationKind 是
enumerate ， 则- 返回 ? status。
- 否则，
断言 ： iterationKind 是iterate 。- 返回 ?
IteratorClose (iteratorRecord, status)。
- 设置
- 令 result 为
Completion (Evaluation of stmt)。 - 设置
运行执行上下文 的 LexicalEnvironment 为 oldEnv。 - 如果
LoopContinues (result, labelSet) 是false ，则- 如果 iterationKind 是
enumerate ， 则- 返回 ?
UpdateEmpty (result, V)。
- 返回 ?
- 否则，
断言 ： iterationKind 是iterate 。- 设置 status 为
Completion (UpdateEmpty (result, V))。 - 如果 iteratorKind 是
async ， 返回 ?AsyncIteratorClose (iteratorRecord, status)。 - 返回 ?
IteratorClose (iteratorRecord, status)。
- 如果 iterationKind 是
- 如果 result.[[Value]] 不是
empty ，设置 V 为 result.[[Value]]。
- 令 nextResult 为 ?
14.7.5.8 运行时语义：Evaluation
- 令 bindingId 为
BindingIdentifier 的StringValue 。 - 返回 ?
ResolveBinding (bindingId)。
14.7.5.9 EnumerateObjectProperties ( O )
抽象操作 EnumerateObjectProperties 接受参数 O（一个对象），并返回一个
throw 和
return 方法是 next
方法处理对象属性以确定next
方法处理之前被删除的属性将被忽略。如果在枚举期间向目标对象添加新属性，则不保证新添加的属性会在活跃的枚举中被处理。next 方法返回一次。
枚举目标对象的属性包括枚举其原型的属性，以及原型的原型，依此类推，递归进行；但如果原型的属性与已经被next
方法处理过的属性同名，则该原型属性不会被处理。在确定原型对象的属性是否已被处理时，不考虑 [[Enumerable]]
特性的值。原型对象的可枚举属性名必须通过调用 EnumerateObjectProperties 并传递原型对象作为参数来获得。EnumerateObjectProperties
必须通过调用目标对象的 [[OwnPropertyKeys]] 内部方法来获得目标对象的自有
此外，如果 O 或其原型链中的任何对象都不是
- O 或其原型链中对象的 [[Prototype]] 内部槽的值发生变化，
- 从 O 或其原型链中的对象删除了一个属性，
- 向 O 的原型链中的对象添加了一个属性，或
- O 或其原型链中对象的属性的 [[Enumerable]] 特性值发生变化。
ECMAScript 实现不需要直接实现
以下是符合这些规则的 ECMAScript 生成器函数的信息性定义：
function* EnumerateObjectProperties(obj) {
const visited = new Set();
for (const key of Reflect.ownKeys(obj)) {
if (typeof key === "symbol") continue;
const desc = Reflect.getOwnPropertyDescriptor(obj, key);
if (desc) {
visited.add(key);
if (desc.enumerable) yield key;
}
}
const proto = Reflect.getPrototypeOf(obj);
if (proto === null) return;
for (const protoKey of EnumerateObjectProperties(proto)) {
if (!visited.has(protoKey)) yield protoKey;
}
}14.7.5.10 For-In 迭代器对象
For-In
迭代器是表示对某个特定对象进行特定迭代的对象。For-In 迭代器对象永远不能直接被 ECMAScript 代码访问；它们只是为了说明
14.7.5.10.1 CreateForInIterator ( object )
抽象操作 CreateForInIterator 接受参数 object（一个对象），并返回一个
- 令 iterator 为
OrdinaryObjectCreate (%ForInIteratorPrototype% , « [[Object]], [[ObjectWasVisited]], [[VisitedKeys]], [[RemainingKeys]] »)。 - 设置 iterator.[[Object]] 为 object。
- 设置 iterator.[[ObjectWasVisited]] 为
false 。 - 设置 iterator.[[VisitedKeys]] 为一个新的空
列表 。 - 设置 iterator.[[RemainingKeys]]
为一个新的空
列表 。 - 返回 iterator。
14.7.5.10.2 %ForInIteratorPrototype% 对象
%ForInIteratorPrototype% 对象：
- 具有被所有
For-In 迭代器对象 继承的属性。 - 是一个
普通对象 。 - 有一个 [[Prototype]] 内部槽，其值是
%Iterator.prototype% 。 - 永远不能直接被 ECMAScript 代码访问。
- 具有以下属性：
14.7.5.10.2.1 %ForInIteratorPrototype%.next ( )
- 令 O 为
this 值。 断言 ： O是对象 。断言 ： O 具有For-In 迭代器 实例的所有内部槽（14.7.5.10.3 ）。- 令 object 为 O.[[Object]]。
- 重复，
- 如果 O.[[ObjectWasVisited]] 是
false ，则- 令 keys 为 ? object.[[OwnPropertyKeys]]()。
- 对 keys 的每个元素 key，执行
- 如果 key
是字符串 ，则- 将 key 追加到 O.[[RemainingKeys]]。
- 如果 key
- 设置 O.[[ObjectWasVisited]]
为
true 。
- 重复，当 O.[[RemainingKeys]] 不为空时，
- 令 r 为 O.[[RemainingKeys]] 的第一个元素。
- 从 O.[[RemainingKeys]] 中移除第一个元素。
- 如果 O.[[VisitedKeys]]
不包含 r，则
- 令 desc 为 ? object.[[GetOwnProperty]](r)。
- 如果 desc 不是
undefined ，则- 将 r 追加到 O.[[VisitedKeys]]。
- 如果 desc.[[Enumerable]] 是
true ，返回CreateIteratorResultObject (r,false )。
- 设置 object 为 ? object.[[GetPrototypeOf]]()。
- 设置 O.[[Object]] 为 object。
- 设置 O.[[ObjectWasVisited]] 为
false 。 - 如果 object 是
null ，返回CreateIteratorResultObject (undefined ,true )。
- 如果 O.[[ObjectWasVisited]] 是
14.7.5.10.3 For-In 迭代器实例的属性
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[Object]] | 一个对象 | 正在迭代其属性的对象值。 |
| [[ObjectWasVisited]] | 一个布尔值 |
如果 |
| [[VisitedKeys]] |
一个包含字符串的 |
到目前为止已被此 |
| [[RemainingKeys]] |
一个包含字符串的 |
在迭代其原型的属性之前（如果其原型不是 |
14.8 continue 语句
语法
14.8.1 静态语义：早期错误
-
如果此
ContinueStatement 没有直接或间接地（但不跨越函数或static初始化块边界）嵌套在IterationStatement 内，则是语法错误。
14.8.2 运行时语义：Evaluation
- 返回
完成记录 { [[Type]]:continue , [[Value]]:empty , [[Target]]:empty }。
- 令 label 为
LabelIdentifier 的StringValue 。 - 返回
完成记录 { [[Type]]:continue , [[Value]]:empty , [[Target]]: label }。
14.9 break 语句
语法
14.9.1 静态语义：早期错误
-
如果此
BreakStatement 没有直接或间接地（但不跨越函数或static初始化块边界）嵌套在IterationStatement 或SwitchStatement 内，则是语法错误。
14.9.2 运行时语义：Evaluation
- 返回
完成记录 { [[Type]]:break , [[Value]]:empty , [[Target]]:empty }。
- 令 label 为
LabelIdentifier 的StringValue 。 - 返回
完成记录 { [[Type]]:break , [[Value]]:empty , [[Target]]: label }。
14.10 return 语句
语法
return 语句使函数停止执行，并且在大多数情况下将值返回给调用者。如果省略了 return
语句可能实际上不会将值返回给调用者。例如，在 try 块中，return
语句的finally 块进行求值期间被另一个
14.10.1 运行时语义：Evaluation
- 返回
ReturnCompletion (undefined )。
- 令 exprRef 为 ?
Evaluation ofExpression 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 如果
GetGeneratorKind () 是async ，设置 exprValue 为 ?Await (exprValue)。 - 返回
ReturnCompletion (exprValue)。
14.11 with 语句
语法
14.11.1 静态语义：早期错误
-
如果
IsStrict (此产生式) 是true ，则是语法错误。 -
如果
IsLabelledFunction (Statement ) 是true ，则是语法错误。
只有在实现了
14.11.2 运行时语义：Evaluation
- 令 val 为 ?
Evaluation ofExpression 。 - 令 obj 为 ?
ToObject (?GetValue (val))。 - 令 oldEnv 为
运行执行上下文 的 LexicalEnvironment。 - 令 newEnv 为
NewObjectEnvironment (obj,true , oldEnv)。 - 设置
运行执行上下文 的 LexicalEnvironment 为 newEnv。 - 令 C 为
Completion (Evaluation ofStatement )。 - 设置
运行执行上下文 的 LexicalEnvironment 为 oldEnv。 - 返回 ?
UpdateEmpty (C,undefined )。
14.12 switch 语句
语法
14.12.1 静态语义：早期错误
-
如果
CaseBlock 的LexicallyDeclaredNames 包含任何重复条目，则是语法错误。 -
如果
CaseBlock 的LexicallyDeclaredNames 中的任何元素也出现在CaseBlock 的VarDeclaredNames 中，则是语法错误。
14.12.2 运行时语义：CaseBlockEvaluation
- 返回
undefined 。
- 令 V 为
undefined 。 - 令 A 为
CaseClauses 中按源文本顺序排列的CaseClause 项的列表 。 - 令 found 为
false 。 - 对于 A 中的每个
CaseClause C，执行- 如果 found 是
false ，则- 设置 found 为 ?
CaseClauseIsSelected (C, input)。
- 设置 found 为 ?
- 如果 found 是
true ，则- 令 R 为
Completion (Evaluation of C)。 - 如果 R.[[Value]] 不是
empty ，设置 V 为 R.[[Value]]。 - 如果 R 是
突然完成 ，返回 ?UpdateEmpty (R, V)。
- 令 R 为
- 如果 found 是
- 返回 V。
- 令 V 为
undefined 。 - 如果第一个
CaseClauses 存在，则- 令 A 为第一个
CaseClauses 中按源文本顺序排列的CaseClause 项的列表 。
- 令 A 为第一个
- 否则，
- 令 A 为一个新的空
列表 。
- 令 A 为一个新的空
- 令 found 为
false 。 - 对于 A 中的每个
CaseClause C，执行- 如果 found 是
false ，则- 设置 found 为 ?
CaseClauseIsSelected (C, input)。
- 设置 found 为 ?
- 如果 found 是
true ，则- 令 R 为
Completion (Evaluation of C)。 - 如果 R.[[Value]] 不是
empty ，设置 V 为 R.[[Value]]。 - 如果 R 是
突然完成 ，返回 ?UpdateEmpty (R, V)。
- 令 R 为
- 如果 found 是
- 令 foundInB 为
false 。 - 如果第二个
CaseClauses 存在，则- 令 B 为第二个
CaseClauses 中按源文本顺序排列的CaseClause 项的列表 。
- 令 B 为第二个
- 否则，
- 令 B 为一个新的空
列表 。
- 令 B 为一个新的空
- 如果 found 是
false ，则- 对于 B 中的每个
CaseClause C，执行- 如果 foundInB 是
false ，则- 设置 foundInB 为 ?
CaseClauseIsSelected (C, input)。
- 设置 foundInB 为 ?
- 如果 foundInB 是
true ，则- 令 R 为
Completion (Evaluation ofCaseClause C)。 - 如果 R.[[Value]] 不是
empty ，设置 V 为 R.[[Value]]。 - 如果 R 是
突然完成 ，返回 ?UpdateEmpty (R, V)。
- 令 R 为
- 如果 foundInB 是
- 对于 B 中的每个
- 如果 foundInB 是
true ，返回 V。 - 令 defaultR 为
Completion (Evaluation ofDefaultClause )。 - 如果 defaultR.[[Value]] 不是
empty ，设置 V 为 defaultR.[[Value]]。 - 如果 defaultR 是
突然完成 ，返回 ?UpdateEmpty (defaultR, V)。 - 注：以下是对第二个
CaseClauses 的另一次完整迭代。 - 对于 B 中的每个
CaseClause C，执行- 令 R 为
Completion (Evaluation ofCaseClause C)。 - 如果 R.[[Value]] 不是
empty ，设置 V 为 R.[[Value]]。 - 如果 R 是
突然完成 ，返回 ?UpdateEmpty (R, V)。
- 令 R 为
- 返回 V。
14.12.3 CaseClauseIsSelected ( C, input )
抽象操作 CaseClauseIsSelected 接受参数 C（一个
断言 ： C 是产生式CaseClause : case Expression : StatementList opt - 令 exprRef 为 ?
Evaluation of C 的Expression 。 - 令 clauseSelector 为 ?
GetValue (exprRef)。 - 返回
IsStrictlyEqual (input, clauseSelector)。
此操作不执行 C 的
14.12.4 运行时语义：Evaluation
- 令 exprRef 为 ?
Evaluation ofExpression 。 - 令 switchValue 为 ?
GetValue (exprRef)。 - 令 oldEnv 为
运行执行上下文 的 LexicalEnvironment。 - 令 blockEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 执行
BlockDeclarationInstantiation (CaseBlock , blockEnv)。 - 设置
运行执行上下文 的 LexicalEnvironment 为 blockEnv。 - 令 R 为
Completion (CaseBlockEvaluation ofCaseBlock with argument switchValue)。 - 设置
运行执行上下文 的 LexicalEnvironment 为 oldEnv。 - 返回 R。
无论控制如何离开
- 返回
empty 。
- 返回 ?
Evaluation ofStatementList 。
- 返回
empty 。
- 返回 ?
Evaluation ofStatementList 。
14.13 标签语句
语法
一个 break
和 continue 语句结合使用。ECMAScript 没有 goto 语句。一个
14.13.1 静态语义：早期错误
- 如果任何源文本匹配此产生式，则是语法错误。
此规则的替代定义在
14.13.2 静态语义：IsLabelledFunction ( stmt )
抽象操作 IsLabelledFunction 接受参数 stmt（一个
- 如果 stmt 不是
LabelledStatement ，返回false 。 - 令 item 为 stmt 的
LabelledItem 。 - 如果 item 是
LabelledItem : FunctionDeclaration true 。 - 令 subStmt 为 item 的
Statement 。 - 返回
IsLabelledFunction (subStmt)。
14.13.3 运行时语义：Evaluation
- 返回 ?
LabelledEvaluation of thisLabelledStatement with argument « »。
14.13.4 运行时语义：LabelledEvaluation
- 令 stmtResult 为
Completion (LoopEvaluation ofIterationStatement with argument labelSet)。 - 如果 stmtResult 是
break 完成 ，则- 如果 stmtResult.[[Target]] 是
empty ，则- 如果 stmtResult.[[Value]] 是
empty ，设置 stmtResult 为NormalCompletion (undefined )。 - 否则，设置 stmtResult 为
NormalCompletion (stmtResult.[[Value]])。
- 如果 stmtResult.[[Value]] 是
- 如果 stmtResult.[[Target]] 是
- 返回 ? stmtResult。
- 令 stmtResult 为
Completion (Evaluation ofSwitchStatement )。 - 如果 stmtResult 是
break 完成 ，则- 如果 stmtResult.[[Target]] 是
empty ，则- 如果 stmtResult.[[Value]] 是
empty ，设置 stmtResult 为NormalCompletion (undefined )。 - 否则，设置 stmtResult 为
NormalCompletion (stmtResult.[[Value]])。
- 如果 stmtResult.[[Value]] 是
- 如果 stmtResult.[[Target]] 是
- 返回 ? stmtResult。
- 令 label 为
LabelIdentifier 的StringValue 。 - 令 newLabelSet 为
labelSet 和 « label » 的
列表连接 。 - 令 stmtResult 为
Completion (LabelledEvaluation ofLabelledItem with argument newLabelSet)。 - 如果 stmtResult 是
break 完成 且 stmtResult.[[Target]] 是 label，则- 设置 stmtResult 为
NormalCompletion (stmtResult.[[Value]])。
- 设置 stmtResult 为
- 返回 ? stmtResult。
- 返回 ?
Evaluation ofFunctionDeclaration 。
- 返回 ?
Evaluation ofStatement 。
14.14 throw 语句
语法
14.14.1 运行时语义：Evaluation
- 令 exprRef 为 ?
Evaluation ofExpression 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 返回
ThrowCompletion (exprValue)。
14.15 try 语句
语法
try 语句包含一个可能发生异常情况的代码块，比如运行时错误或 throw 语句。catch
子句提供异常处理代码。当 catch 子句捕获异常时，其
14.15.1 静态语义：早期错误
-
如果
CatchParameter 的BoundNames 包含任何重复元素，则是语法错误。 -
如果
CatchParameter 的BoundNames 中的任何元素也出现在Block 的LexicallyDeclaredNames 中，则是语法错误。 -
如果
CatchParameter 的BoundNames 中的任何元素也出现在Block 的VarDeclaredNames 中，则是语法错误。
14.15.2 运行时语义：CatchClauseEvaluation
- 令 oldEnv 为
运行执行上下文 的 LexicalEnvironment。 - 令 catchEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 对于
CatchParameter 的BoundNames 中的每个元素 argName，执行- 执行 ! catchEnv.CreateMutableBinding(argName,
false )。
- 执行 ! catchEnv.CreateMutableBinding(argName,
- 设置
运行执行上下文 的 LexicalEnvironment 为 catchEnv。 - 令 status 为
Completion (BindingInitialization ofCatchParameter with arguments thrownValue and catchEnv)。 - 如果 status 是
突然完成 ，则- 设置
运行执行上下文 的 LexicalEnvironment 为 oldEnv。 - 返回 ? status。
- 设置
- 令 B 为
Completion (Evaluation ofBlock )。 - 设置
运行执行上下文 的 LexicalEnvironment 为 oldEnv。 - 返回 ? B。
- 返回 ?
Evaluation ofBlock 。
无论控制如何离开
14.15.3 运行时语义：Evaluation
- 令 B 为
Completion (Evaluation ofBlock )。 - 如果 B 是
throw 完成 ，令 C 为Completion (CatchClauseEvaluation ofCatch with argument B.[[Value]])。 - 否则，令 C 为 B。
- 返回 ?
UpdateEmpty (C,undefined )。
- 令 B 为
Completion (Evaluation ofBlock )。 - 令 F 为
Completion (Evaluation ofFinally )。 - 如果 F 是
正常完成 ，设置 F 为 B。 - 返回 ?
UpdateEmpty (F,undefined )。
- 令 B 为
Completion (Evaluation ofBlock )。 - 如果 B 是
throw 完成 ，令 C 为Completion (CatchClauseEvaluation ofCatch with argument B.[[Value]])。 - 否则，令 C 为 B。
- 令 F 为
Completion (Evaluation ofFinally )。 - 如果 F 是
正常完成 ，设置 F 为 C。 - 返回 ?
UpdateEmpty (F,undefined )。
14.16 debugger 语句
语法
14.16.1 运行时语义：Evaluation
计算
15 ECMAScript 语言：函数和类
各种 ECMAScript 语言元素会导致创建 ECMAScript
15.1 参数列表
语法
15.1.1 静态语义：早期错误
-
如果
FormalParameters 的BoundNames 包含任何重复元素，则是语法错误。
-
如果
FormalParameterList 的IsSimpleParameterList 是false 且FormalParameterList 的BoundNames 包含任何重复元素，则是语法错误。
相同
15.1.2 静态语义：ContainsExpression
- 返回
false 。
- 返回
false 。
- 令 has 为
BindingElementList 的ContainsExpression 。 - 如果 has 是
true ，返回true 。 - 返回
BindingRestElement 的ContainsExpression 。
- 令 has 为
BindingPropertyList 的ContainsExpression 。 - 如果 has 是
true ，返回true 。 - 返回
BindingProperty 的ContainsExpression 。
- 令 has 为
BindingElementList 的ContainsExpression 。 - 如果 has 是
true ，返回true 。 - 返回
BindingElisionElement 的ContainsExpression 。
- 令 has 为
PropertyName 的IsComputedPropertyKey 。 - 如果 has 是
true ，返回true 。 - 返回
BindingElement 的ContainsExpression 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
false 。
- 如果
FormalParameterList 的ContainsExpression 是true ，返回true 。 - 返回
FunctionRestParameter 的ContainsExpression 。
- 如果
FormalParameterList 的ContainsExpression 是true ，返回true 。 - 返回
FormalParameter 的ContainsExpression 。
- 返回
false 。
- 令 formals 为由
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ArrowFormalParameters 。 - 返回 formals 的
ContainsExpression 。
- 返回
false 。
15.1.3 静态语义：IsSimpleParameterList
- 返回
false 。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
false 。
- 如果
FormalParameterList 的IsSimpleParameterList 是false ，返回false 。 - 返回
FormalParameter 的IsSimpleParameterList 。
- 返回
true 。
- 令 formals 为由
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ArrowFormalParameters 。 - 返回 formals 的
IsSimpleParameterList 。
- 返回
true 。
- 令 head 为由
CoverCallExpressionAndAsyncArrowHead 覆盖 的AsyncArrowHead 。 - 返回 head 的
IsSimpleParameterList 。
15.1.4 静态语义：HasInitializer
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 如果
FormalParameterList 的HasInitializer 是true ，返回true 。 - 返回
FormalParameter 的HasInitializer 。
15.1.5 静态语义：ExpectedArgumentCount
- 返回 0。
- 如果
FormalParameter 的HasInitializer 是true ，返回 0。 - 返回 1。
- 令 count 为
FormalParameterList 的ExpectedArgumentCount 。 - 如果
FormalParameterList 的HasInitializer 是true 或FormalParameter 的HasInitializer 是true ，返回 count。 - 返回 count + 1。
- 返回 1。
- 令 formals 为由
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ArrowFormalParameters 。 - 返回 formals 的
ExpectedArgumentCount 。
- 如果
FormalParameter 的HasInitializer 是true ，返回 0。 - 返回 1。
- 返回 1。
15.2 函数定义
语法
15.2.1 静态语义：早期错误
-
如果
IsStrict (FormalParameters ) 是true ，则应用UniqueFormalParameters : FormalParameters -
如果存在
BindingIdentifier 且IsStrict (BindingIdentifier ) 是true ，如果BindingIdentifier 的StringValue 是"eval" 或"arguments" ，则是语法错误。 -
如果
FunctionBody 的FunctionBodyContainsUseStrict 是true 且FormalParameters 的IsSimpleParameterList 是false ，则是语法错误。 -
如果
FormalParameters 的BoundNames 的任何元素也出现在FunctionBody 的LexicallyDeclaredNames 中，则是语法错误。 -
如果
FormalParameters Contains SuperProperty 是true ，则是语法错误。 -
如果
FunctionBody Contains SuperProperty 是true ，则是语法错误。 -
如果
FormalParameters Contains SuperCall 是true ，则是语法错误。 -
如果
FunctionBody Contains SuperCall 是true ，则是语法错误。
-
如果
FunctionStatementList 的LexicallyDeclaredNames 包含任何重复条目，则是语法错误。 -
如果
FunctionStatementList 的LexicallyDeclaredNames 的任何元素也出现在FunctionStatementList 的VarDeclaredNames 中，则是语法错误。 -
如果以参数 « » 调用
FunctionStatementList 的ContainsDuplicateLabels 是true ，则是语法错误。 -
如果以参数 « » 调用
FunctionStatementList 的ContainsUndefinedBreakTarget 是true ，则是语法错误。 -
如果以参数 « » 和 « » 调用
FunctionStatementList 的ContainsUndefinedContinueTarget 是true ，则是语法错误。
15.2.2 静态语义：FunctionBodyContainsUseStrict
- 如果
FunctionBody 的指令序言 包含一个Use Strict 指令 ，返回true ；否则，返回false 。
15.2.3 运行时语义：EvaluateFunctionBody
- 执行 ?
FunctionDeclarationInstantiation (functionObject, argumentsList)。 - 执行 ?
Evaluation ofFunctionStatementList 。 - 注：如果前面的步骤产生了一个
normal completion ，那么求值通过继续执行到FunctionStatementList 的末尾而结束。 - 返回
ReturnCompletion (undefined )。
15.2.4 运行时语义：InstantiateOrdinaryFunctionObject
- 令 name 为
BindingIdentifier 的StringValue 。 - 令 sourceText 为
FunctionDeclaration 匹配的源文本 。 - 令 F 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F, name)。 - 执行
MakeConstructor (F)。 - 返回 F。
- 令 sourceText 为
FunctionDeclaration 匹配的源文本 。 - 令 F 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F,"default" )。 - 执行
MakeConstructor (F)。 - 返回 F。
匿名 export default 声明的一部分出现，因此其函数代码总是
15.2.5 运行时语义：InstantiateOrdinaryFunctionExpression
- 如果不存在 name，设置 name 为
"" 。 - 令 env 为
运行执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
FunctionExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 执行
MakeConstructor (closure)。 - 返回 closure。
断言 ：name 不存在。- 设置 name 为
BindingIdentifier 的StringValue 。 - 令 outerEnv 为
运行执行上下文 的 LexicalEnvironment。 - 令 funcEnv 为
NewDeclarativeEnvironment (outerEnv)。 - 执行 ! funcEnv.CreateImmutableBinding(name,
false )。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
FunctionExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , funcEnv, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 执行
MakeConstructor (closure)。 - 执行 ! funcEnv.InitializeBinding(name, closure)。
- 返回 closure。
15.2.6 运行时语义：Evaluation
- 返回
empty 。
在
- 返回
empty 。
对于使用
- 返回
undefined 。
15.3 箭头函数定义
语法
补充语法
当处理产生式的实例
时，
15.3.1 静态语义：早期错误
-
如果
ArrowParameters Contains YieldExpression 是true ，则是语法错误。 -
如果
ArrowParameters Contains AwaitExpression 是true ，则是语法错误。 -
如果
ConciseBody 的ConciseBodyContainsUseStrict 是true 且ArrowParameters 的IsSimpleParameterList 是false ，则是语法错误。 -
如果
ArrowParameters 的BoundNames 的任何元素也出现在ConciseBody 的LexicallyDeclaredNames 中，则是语法错误。
15.3.2 静态语义：ConciseBodyContainsUseStrict
- 返回
false 。
15.3.3 运行时语义：EvaluateConciseBody
- 执行 ?
FunctionDeclarationInstantiation (functionObject, argumentsList)。 - 返回 ?
Evaluation ofExpressionBody 。
15.3.4 运行时语义：InstantiateArrowFunctionExpression
- 如果不存在 name，设置 name 为
"" 。 - 令 env 为
运行执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
ArrowFunction 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,ArrowParameters ,ConciseBody ,lexical-this , env, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 返回 closure。
arguments、super、this 或 new.target
定义局部绑定。arguments、super、this 或 new.target
的任何引用都必须解析为词法封闭环境中的绑定。通常这会是紧邻封闭函数的函数环境。尽管 super
的引用，但在步骤 super 的 super 所需的状态可以通过被
15.3.5 运行时语义：Evaluation
- 令 exprRef 为 ?
Evaluation ofAssignmentExpression 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 返回
ReturnCompletion (exprValue)。
15.4 方法定义
语法
15.4.1 静态语义：早期错误
-
如果
FunctionBody 的FunctionBodyContainsUseStrict 是true 且UniqueFormalParameters 的IsSimpleParameterList 是false ，则是语法错误。 -
如果
UniqueFormalParameters 的BoundNames 的任何元素也出现在FunctionBody 的LexicallyDeclaredNames 中，则是语法错误。
-
如果
PropertySetParameterList 的BoundNames 包含任何重复元素，则是语法错误。 -
如果
FunctionBody 的FunctionBodyContainsUseStrict 是true 且PropertySetParameterList 的IsSimpleParameterList 是false ，则是语法错误。 -
如果
PropertySetParameterList 的BoundNames 的任何元素也出现在FunctionBody 的LexicallyDeclaredNames 中，则是语法错误。
15.4.2 静态语义：HasDirectSuper
- 如果
UniqueFormalParameters Contains SuperCall 是true ，返回true 。 - 返回
FunctionBody Contains SuperCall 。
- 如果
PropertySetParameterList Contains SuperCall 是true ，返回true 。 - 返回
FunctionBody Contains SuperCall 。
- 如果
UniqueFormalParameters Contains SuperCall 是true ，返回true 。 - 返回
GeneratorBody Contains SuperCall 。
- 如果
UniqueFormalParameters Contains SuperCall 是true ，返回true 。 - 返回
AsyncGeneratorBody Contains SuperCall 。
- 如果
UniqueFormalParameters Contains SuperCall 是true ，返回true 。 - 返回
AsyncFunctionBody Contains SuperCall 。
15.4.3 静态语义：SpecialMethod
- 返回
false 。
- 返回
true 。
15.4.4 运行时语义：DefineMethod
- 令 propKey 为 ?
Evaluation ofClassElementName 。 - 令 env 为
运行执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 如果存在 functionPrototype，那么
- 令 prototype 为 functionPrototype。
- 否则，
- 令 prototype 为
%Function.prototype% 。
- 令 prototype 为
- 令 sourceText 为
MethodDefinition 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (prototype, sourceText,UniqueFormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (closure, object)。 - 返回
Record { [[Key]]: propKey, [[Closure]]: closure }。
15.4.5 运行时语义：MethodDefinitionEvaluation
- 令 methodDef 为
MethodDefinition 以参数 object 的 ?DefineMethod 。 - 执行
SetFunctionName (methodDef.[[Closure]], methodDef.[[Key]])。 - 返回 ?
DefineMethodProperty (object, methodDef.[[Key]], methodDef.[[Closure]], enumerable)。
- 令 propKey 为 ?
Evaluation ofClassElementName 。 - 令 env 为
运行执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
MethodDefinition 匹配的源文本 。 - 令 formalParameterList 为产生式
FormalParameters : [empty] - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParameterList,FunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (closure, object)。 - 执行
SetFunctionName (closure, propKey,"get" )。 - 如果 propKey 是
私有名称 ，那么- 返回
PrivateElement { [[Key]]: propKey, [[Kind]]:accessor , [[Get]]: closure, [[Set]]:undefined }。
- 返回
- 否则，
- 令 desc 为 PropertyDescriptor { [[Get]]:
closure, [[Enumerable]]:
enumerable, [[Configurable]]:
true }。 - 执行 ?
DefinePropertyOrThrow (object, propKey, desc)。 - 返回
unused 。
- 令 desc 为 PropertyDescriptor { [[Get]]:
closure, [[Enumerable]]:
enumerable, [[Configurable]]:
- 令 propKey 为 ?
Evaluation ofClassElementName 。 - 令 env 为
运行执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
MethodDefinition 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,PropertySetParameterList ,FunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (closure, object)。 - 执行
SetFunctionName (closure, propKey,"set" )。 - 如果 propKey 是
私有名称 ，那么- 返回
PrivateElement { [[Key]]: propKey, [[Kind]]:accessor , [[Get]]:undefined , [[Set]]: closure }。
- 返回
- 否则，
- 令 desc 为 PropertyDescriptor { [[Set]]:
closure, [[Enumerable]]:
enumerable, [[Configurable]]:
true }。 - 执行 ?
DefinePropertyOrThrow (object, propKey, desc)。 - 返回
unused 。
- 令 desc 为 PropertyDescriptor { [[Set]]:
closure, [[Enumerable]]:
enumerable, [[Configurable]]:
- 令 propKey 为 ?
Evaluation ofClassElementName 。 - 令 env 为
运行执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
GeneratorMethod 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,UniqueFormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (closure, object)。 - 执行
SetFunctionName (closure, propKey)。 - 令 prototype 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 ?
DefineMethodProperty (object, propKey, closure, enumerable)。
- 令 propKey 为 ?
Evaluation ofClassElementName 。 - 令 env 为
运行执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
AsyncGeneratorMethod 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,UniqueFormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (closure, object)。 - 执行
SetFunctionName (closure, propKey)。 - 令 prototype 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 ?
DefineMethodProperty (object, propKey, closure, enumerable)。
- 令 propKey 为 ?
Evaluation ofClassElementName 。 - 令 env 为
运行执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
AsyncMethod 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,UniqueFormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (closure, object)。 - 执行
SetFunctionName (closure, propKey)。 - 返回 ?
DefineMethodProperty (object, propKey, closure, enumerable)。
15.5 生成器函数定义
语法
紧跟在 yield 后面的语法上下文需要使用
15.5.1 静态语义：早期错误
-
如果
GeneratorMethod 的HasDirectSuper 是true ，则是语法错误。 -
如果
UniqueFormalParameters Contains YieldExpression 是true ，则是语法错误。 -
如果
GeneratorBody 的FunctionBodyContainsUseStrict 是true 且UniqueFormalParameters 的IsSimpleParameterList 是false ，则是语法错误。 -
如果
UniqueFormalParameters 的BoundNames 的任何元素也出现在GeneratorBody 的LexicallyDeclaredNames 中，则是语法错误。
-
如果
IsStrict (FormalParameters ) 是true ，则应用UniqueFormalParameters : FormalParameters -
如果存在
BindingIdentifier 且IsStrict (BindingIdentifier ) 是true ，如果BindingIdentifier 的StringValue 是"eval" 或"arguments" ，则是语法错误。 -
如果
GeneratorBody 的FunctionBodyContainsUseStrict 是true 且FormalParameters 的IsSimpleParameterList 是false ，则是语法错误。 -
如果
FormalParameters 的BoundNames 的任何元素也出现在GeneratorBody 的LexicallyDeclaredNames 中，则是语法错误。 -
如果
FormalParameters Contains YieldExpression 是true ，则是语法错误。 -
如果
FormalParameters Contains SuperProperty 是true ，则是语法错误。 -
如果
GeneratorBody Contains SuperProperty 是true ，则是语法错误。 -
如果
FormalParameters Contains SuperCall 是true ，则是语法错误。 -
如果
GeneratorBody Contains SuperCall 是true ，则是语法错误。
15.5.2 运行时语义：EvaluateGeneratorBody
- 执行 ?
FunctionDeclarationInstantiation (functionObject, argumentsList)。 - 令 G 为 ?
OrdinaryCreateFromConstructor (functionObject,"%GeneratorPrototype%" , « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] »)。 - 设置 G.[[GeneratorBrand]] 为
empty 。 - 设置 G.[[GeneratorState]] 为
suspended-start 。 - 执行
GeneratorStart (G,FunctionBody )。 - 返回
ReturnCompletion (G)。
15.5.3 运行时语义：InstantiateGeneratorFunctionObject
- 令 name 为
BindingIdentifier 的StringValue 。 - 令 sourceText 为
GeneratorDeclaration 匹配的源文本 。 - 令 F 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F, name)。 - 令 prototype 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 F。
- 令 sourceText 为
GeneratorDeclaration 匹配的源文本 。 - 令 F 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F,"default" )。 - 令 prototype 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 F。
匿名的 export default 声明的一部分出现，因此其函数代码总是
15.5.4 运行时语义：InstantiateGeneratorFunctionExpression
- 如果 name 不存在，设置 name 为
"" 。 - 令 env 为
运行执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
GeneratorExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 令 prototype 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 closure。
断言 ：name 不存在。- 设置 name 为
BindingIdentifier 的StringValue 。 - 令 outerEnv 为
运行执行上下文 的 LexicalEnvironment。 - 令 funcEnv 为
NewDeclarativeEnvironment (outerEnv)。 - 执行 ! funcEnv.CreateImmutableBinding(name,
false )。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
GeneratorExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , funcEnv, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 令 prototype 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 执行 ! funcEnv.InitializeBinding(name, closure)。
- 返回 closure。
15.5.5 运行时语义：Evaluation
- 返回 ?
Yield (undefined )。
- 令 exprRef 为 ?
Evaluation ofAssignmentExpression 。 - 令 value 为 ?
GetValue (exprRef)。 - 返回 ?
Yield (value)。
- 令 generatorKind 为
GetGeneratorKind ()。 断言 ：generatorKind 是sync 或async 。- 令 exprRef 为 ?
Evaluation ofAssignmentExpression 。 - 令 value 为 ?
GetValue (exprRef)。 - 令 iteratorRecord 为 ?
GetIterator (value, generatorKind)。 - 令 iterator 为 iteratorRecord.[[Iterator]]。
- 令 received 为
NormalCompletion (undefined )。 - 重复，
- 如果 received 是一个
normal completion ，那么- 令 innerResult 为 ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « received.[[Value]] »)。 - 如果 generatorKind 是
async ，设置 innerResult 为 ?Await (innerResult)。 - 如果 innerResult
不是 Object ，抛出TypeError 异常。 - 令 done 为 ?
IteratorComplete (innerResult)。 - 如果 done 是
true ，那么- 返回 ?
IteratorValue (innerResult)。
- 返回 ?
- 如果 generatorKind 是
async ，设置 received 为Completion (AsyncGeneratorYield (?IteratorValue (innerResult)))。 - 否则，设置 received 为
Completion (GeneratorYield (innerResult))。
- 令 innerResult 为 ?
- 否则如果 received 是一个
throw completion ，那么- 令 throw 为 ?
GetMethod (iterator,"throw" )。 - 如果 throw 不是
undefined ，那么- 令 innerResult 为 ?
Call (throw, iterator, « received.[[Value]] »)。 - 如果 generatorKind 是
async ，设置 innerResult 为 ?Await (innerResult)。 - 注释：来自内部
迭代器 throw方法的异常会被传播。来自内部throw方法的Normal completion 的处理方式与内部next类似。 - 如果 innerResult
不是 Object ，抛出TypeError 异常。 - 令 done 为 ?
IteratorComplete (innerResult)。 - 如果 done 是
true ，那么- 返回 ?
IteratorValue (innerResult)。
- 返回 ?
- 如果 generatorKind 是
async ，设置 received 为Completion (AsyncGeneratorYield (?IteratorValue (innerResult)))。 - 否则，设置 received 为
Completion (GeneratorYield (innerResult))。
- 令 innerResult 为 ?
- 否则，
- 注释：如果 iterator 没有
throw方法，这个 throw 将终止yield*循环。但首先我们需要给 iterator 一个清理的机会。 - 令 closeCompletion 为
NormalCompletion (empty )。 - 如果 generatorKind 是
async ，执行 ?AsyncIteratorClose (iteratorRecord, closeCompletion)。 - 否则，执行 ?
IteratorClose (iteratorRecord, closeCompletion)。 - 注释：下一步抛出
TypeError 表示存在yield*协议违反：iterator 没有throw方法。 - 抛出
TypeError 异常。
- 注释：如果 iterator 没有
- 令 throw 为 ?
- 否则，
断言 ：received 是一个return completion 。- 令 return 为 ?
GetMethod (iterator,"return" )。 - 如果 return 是
undefined ，那么- 设置 value 为 received.[[Value]]。
- 如果 generatorKind 是
async ，那么- 设置 value 为 ?
Await (value)。
- 设置 value 为 ?
- 返回
ReturnCompletion (value)。
- 令 innerReturnResult 为 ?
Call (return, iterator, « received.[[Value]] »)。 - 如果 generatorKind 是
async ，设置 innerReturnResult 为 ?Await (innerReturnResult)。 - 如果 innerReturnResult
不是 Object ，抛出TypeError 异常。 - 令 done 为 ?
IteratorComplete (innerReturnResult)。 - 如果 done 是
true ，那么- 设置 value 为 ?
IteratorValue (innerReturnResult)。 - 返回
ReturnCompletion (value)。
- 设置 value 为 ?
- 如果 generatorKind 是
async ，设置 received 为Completion (AsyncGeneratorYield (?IteratorValue (innerReturnResult)))。 - 否则，设置 received 为
Completion (GeneratorYield (innerReturnResult))。
- 如果 received 是一个
15.6 异步生成器函数定义
语法
15.6.1 静态语义：早期错误
- 如果
AsyncGeneratorMethod 的HasDirectSuper 是true ，则是语法错误。 - 如果
UniqueFormalParameters Contains YieldExpression 是true ，则是语法错误。 - 如果
UniqueFormalParameters Contains AwaitExpression 是true ，则是语法错误。 - 如果
AsyncGeneratorBody 的FunctionBodyContainsUseStrict 是true 且UniqueFormalParameters 的IsSimpleParameterList 是false ，则是语法错误。 - 如果
UniqueFormalParameters 的BoundNames 的任何元素也出现在AsyncGeneratorBody 的LexicallyDeclaredNames 中，则是语法错误。
- 如果
IsStrict (FormalParameters ) 是true ，则应用UniqueFormalParameters : FormalParameters - 如果存在
BindingIdentifier 且IsStrict (BindingIdentifier ) 是true ，如果BindingIdentifier 的StringValue 是"eval" 或"arguments" ，则是语法错误。 - 如果
AsyncGeneratorBody 的FunctionBodyContainsUseStrict 是true 且FormalParameters 的IsSimpleParameterList 是false ，则是语法错误。 - 如果
FormalParameters 的BoundNames 的任何元素也出现在AsyncGeneratorBody 的LexicallyDeclaredNames 中，则是语法错误。 - 如果
FormalParameters Contains YieldExpression 是true ，则是语法错误。 - 如果
FormalParameters Contains AwaitExpression 是true ，则是语法错误。 - 如果
FormalParameters Contains SuperProperty 是true ，则是语法错误。 - 如果
AsyncGeneratorBody Contains SuperProperty 是true ，则是语法错误。 - 如果
FormalParameters Contains SuperCall 是true ，则是语法错误。 - 如果
AsyncGeneratorBody Contains SuperCall 是true ，则是语法错误。
15.6.2 运行时语义：EvaluateAsyncGeneratorBody
- 执行 ?
FunctionDeclarationInstantiation (functionObject, argumentsList)。 - 令 generator 为 ?
OrdinaryCreateFromConstructor (functionObject,"%AsyncGeneratorPrototype%" , « [[AsyncGeneratorState]], [[AsyncGeneratorContext]], [[AsyncGeneratorQueue]], [[GeneratorBrand]] »)。 - 设置 generator.[[GeneratorBrand]] 为
empty 。 - 设置 generator.[[AsyncGeneratorState]] 为
suspended-start 。 - 执行
AsyncGeneratorStart (generator,FunctionBody )。 - 返回
ReturnCompletion (generator)。
15.6.3 运行时语义：InstantiateAsyncGeneratorFunctionObject
- 令 name 为
BindingIdentifier 的StringValue 。 - 令 sourceText 为
AsyncGeneratorDeclaration 匹配的源文本 。 - 令 F 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F, name)。 - 令 prototype 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 F。
- 令 sourceText 为
AsyncGeneratorDeclaration 匹配的源文本 。 - 令 F 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F,"default" )。 - 令 prototype 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 F。
匿名的 export default 声明的一部分出现。
15.6.4 运行时语义：InstantiateAsyncGeneratorFunctionExpression
- 如果 name 不存在，设置 name 为
"" 。 - 令 env 为
运行执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
AsyncGeneratorExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 令 prototype 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 closure。
断言 ：name 不存在。- 设置 name 为
BindingIdentifier 的StringValue 。 - 令 outerEnv 为
运行执行上下文 的 LexicalEnvironment。 - 令 funcEnv 为
NewDeclarativeEnvironment (outerEnv)。 - 执行 ! funcEnv.CreateImmutableBinding(name,
false )。 - 令 privateEnv 为
运行执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
AsyncGeneratorExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , funcEnv, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 令 prototype 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 执行 ! funcEnv.InitializeBinding(name, closure)。
- 返回 closure。
15.6.5 运行时语义：Evaluation
15.7 类定义
语法
类定义始终是
15.7.1 静态语义：早期错误
-
如果
ClassHeritage 不存在且以下算法返回true ，则是语法错误：- 令 constructor 为
ClassBody 的ConstructorMethod 。 - 如果 constructor 是
empty ，返回false 。 - 返回 constructor 的
HasDirectSuper 。
- 令 constructor 为
- 如果
ClassElementList 的PrototypePropertyNameList 包含多个"constructor" ，则是语法错误。 - 如果
ClassElementList 的PrivateBoundIdentifiers 包含任何重复条目，则是语法错误，除非该名称只用于一个 getter 和一个 setter，并且 getter 和 setter 都是静态的或都是非静态的。
- 如果
MethodDefinition 的PropName 不是"constructor" 且MethodDefinition 的HasDirectSuper 是true ，则是语法错误。 - 如果
MethodDefinition 的PropName 是"constructor" 且MethodDefinition 的SpecialMethod 是true ，则是语法错误。
- 如果
MethodDefinition 的HasDirectSuper 是true ，则是语法错误。 - 如果
MethodDefinition 的PropName 是"prototype" ，则是语法错误。
- 如果
FieldDefinition 的PropName 是"constructor" ，则是语法错误。
- 如果
FieldDefinition 的PropName 是"prototype" 或"constructor" ，则是语法错误。
- 如果存在
Initializer 且Initializer 的ContainsArguments 是true ，则是语法错误。 - 如果存在
Initializer 且Initializer Contains SuperCall 是true ，则是语法错误。
- 如果
PrivateIdentifier 的StringValue 是"#constructor" ，则是语法错误。
- 如果
ClassStaticBlockStatementList 的LexicallyDeclaredNames 包含任何重复条目，则是语法错误。 - 如果
ClassStaticBlockStatementList 的LexicallyDeclaredNames 的任何元素也出现在ClassStaticBlockStatementList 的VarDeclaredNames 中，则是语法错误。 - 如果
ClassStaticBlockStatementList 的ContainsDuplicateLabels 在参数 « » 下是true ，则是语法错误。 - 如果
ClassStaticBlockStatementList 的ContainsUndefinedBreakTarget 在参数 « » 下是true ，则是语法错误。 - 如果
ClassStaticBlockStatementList 的ContainsUndefinedContinueTarget 在参数 « » 和 « » 下是true ，则是语法错误。 - 如果
ClassStaticBlockStatementList 的ContainsArguments 是true ，则是语法错误。 - 如果
ClassStaticBlockStatementList Contains SuperCall 是true ，则是语法错误。 - 如果
ClassStaticBlockStatementList Contains await是true ，则是语法错误。
15.7.2 静态语义：ClassElementKind
- 如果
MethodDefinition 的PropName 是"constructor" ，返回constructor-method 。 - 返回
non-constructor-method 。
- 返回
non-constructor-method 。
- 返回
non-constructor-method 。
- 返回
empty 。
15.7.3 静态语义：ConstructorMethod
- 如果
ClassElement 的ClassElementKind 是constructor-method ，返回ClassElement 。 - 返回
empty 。
- 令 head 为
ClassElementList 的ConstructorMethod 。 - 如果 head 不是
empty ，返回 head。 - 如果
ClassElement 的ClassElementKind 是constructor-method ，返回ClassElement 。 - 返回
empty 。
早期错误规则确保只有一个名为
15.7.4 静态语义：IsStatic
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 返回
true 。
- 返回
false 。
15.7.5 静态语义：NonConstructorElements
- 如果
ClassElement 的ClassElementKind 是non-constructor-method ，则- 返回 «
ClassElement »。
- 返回 «
- 返回一个新的空
List 。
- 令 list 为
ClassElementList 的NonConstructorElements 。 - 如果
ClassElement 的ClassElementKind 是non-constructor-method ，则- 将
ClassElement 追加到 list 的末尾。
- 将
- 返回 list。
15.7.6 静态语义：PrototypePropertyNameList
- 令 propName 为
ClassElement 的PropName 。 - 如果 propName 是
empty ，返回一个新的空List 。 - 如果
ClassElement 的IsStatic 是true ，返回一个新的空List 。 - 返回 « propName »。
- 令 list 为
ClassElementList 的PrototypePropertyNameList 。 - 令 propName 为
ClassElement 的PropName 。 - 如果 propName 是
empty ，返回 list。 - 如果
ClassElement 的IsStatic 是true ，返回 list。 - 返回 list 和 « propName » 的
列表连接 。
15.7.7 静态语义：AllPrivateIdentifiersValid
本规范中每个未在下面列出的语法产生式替代都隐含地具有以下 AllPrivateIdentifiersValid 的默认定义：
- 对于此
解析节点 的每个子节点 child，执行- 如果 child 是非终结符的实例，则
- 如果 child 的
AllPrivateIdentifiersValid 在参数 names 下是false ，返回false 。
- 如果 child 的
- 如果 child 是非终结符的实例，则
- 返回
true 。
- 如果 names 包含
PrivateIdentifier 的StringValue ，则- 返回
MemberExpression 的AllPrivateIdentifiersValid 在参数 names 下的结果。
- 返回
- 返回
false 。
- 如果 names 包含
PrivateIdentifier 的StringValue ，则- 返回
CallExpression 的AllPrivateIdentifiersValid 在参数 names 下的结果。
- 返回
- 返回
false 。
- 如果 names 包含
PrivateIdentifier 的StringValue ，返回true 。 - 返回
false 。
- 如果 names 包含
PrivateIdentifier 的StringValue ，则- 返回
OptionalChain 的AllPrivateIdentifiersValid 在参数 names 下的结果。
- 返回
- 返回
false 。
- 令 newNames 为 names 和
ClassBody 的PrivateBoundIdentifiers 的列表连接 。 - 返回
ClassElementList 的AllPrivateIdentifiersValid 在参数 newNames 下的结果。
- 如果 names 包含
PrivateIdentifier 的StringValue ，则- 返回
ShiftExpression 的AllPrivateIdentifiersValid 在参数 names 下的结果。
- 返回
- 返回
false 。
15.7.8 静态语义：PrivateBoundIdentifiers
- 返回一个
List ，其唯一元素是PrivateIdentifier 的StringValue 。
- 返回一个新的空
List 。
- 令 names1 为
ClassElementList 的PrivateBoundIdentifiers 。 - 令 names2 为
ClassElement 的PrivateBoundIdentifiers 。 - 返回 names1 和 names2 的
列表连接 。
15.7.9 静态语义：ContainsArguments
本规范中每个未在下面列出的语法产生式替代都隐含地具有以下 ContainsArguments 的默认定义：
- 对于此
解析节点 的每个子节点 child，执行- 如果 child 是非终结符的实例，则
- 如果 child 的
ContainsArguments 是true ，返回true 。
- 如果 child 的
- 如果 child 是非终结符的实例，则
- 返回
false 。
- 如果
Identifier 的StringValue 是"arguments" ，返回true 。 - 返回
false 。
- 返回
false 。
15.7.10 运行时语义：ClassFieldDefinitionEvaluation
- 令 name 为 ?
ClassElementName 的Evaluation 。 - 如果
Initializer 存在，则- 令 formalParameterList 为产生式
FormalParameters : [empty] - 令 env 为
正在运行的执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
正在运行的执行上下文 的 PrivateEnvironment。 - 令 sourceText 为空的 Unicode 代码点序列。
- 令 initializer 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParameterList,Initializer ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (initializer, homeObject)。 - 设置 initializer.[[ClassFieldInitializerName]] 为 name。
- 令 formalParameterList 为产生式
- 否则，
- 令 initializer 为
empty 。
- 令 initializer 为
- 返回
ClassFieldDefinition Record { [[Name]]: name, [[Initializer]]: initializer }。
15.7.11 运行时语义：ClassStaticBlockDefinitionEvaluation
- 令 lex 为
正在运行的执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
正在运行的执行上下文 的 PrivateEnvironment。 - 令 sourceText 为空的 Unicode 代码点序列。
- 令 formalParameters 为产生式
FormalParameters : [empty] - 令 bodyFunction 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParameters,ClassStaticBlockBody ,non-lexical-this , lex, privateEnv)。 - 执行
MakeMethod (bodyFunction, homeObject)。 - 返回
ClassStaticBlockDefinition Record { [[BodyFunction]]: bodyFunction }。
15.7.12 运行时语义：EvaluateClassStaticBlockBody
断言 ：functionObject 是由ClassStaticBlockDefinitionEvaluation 步骤5 创建的合成函数。- 执行 !
FunctionDeclarationInstantiation (functionObject, « »)。 - 执行 ?
ClassStaticBlockStatementList 的Evaluation 。 - 返回
ReturnCompletion (undefined )。
15.7.13 运行时语义：ClassElementEvaluation
- 返回 ?
FieldDefinition 的ClassFieldDefinitionEvaluation ，参数为 object。
- 返回 ?
MethodDefinition 的MethodDefinitionEvaluation ，参数为 object 和false 。
- 返回
ClassStaticBlock 的ClassStaticBlockDefinitionEvaluation ，参数为 object。
- 返回
unused 。
15.7.14 运行时语义：ClassDefinitionEvaluation
为了便于规范，私有方法和访问器与私有字段一起包含在类实例的 [[PrivateElements]] 槽中。但是，任何给定对象要么拥有给定类定义的所有私有方法和访问器，要么一个都没有。这个特性的设计使得实现可以选择使用不需要单独跟踪每个方法或访问器的策略来实现私有方法和访问器。
例如，实现可以直接将实例私有方法与其相应的 this 值运行过。然后在对象上查找实例私有方法就包括检查定义该方法的类
这与私有字段不同：因为字段初始化器可能在类实例化期间抛出异常，单个对象可能拥有给定类的私有字段的某个真子集，因此私有字段通常必须单独跟踪。
它按以下产生式分段定义：
- 令 env 为
正在运行的执行上下文 的 LexicalEnvironment。 - 令 classEnv 为
NewDeclarativeEnvironment (env)。 - 如果 classBinding 不是
undefined ，则- 执行 ! classEnv.CreateImmutableBinding(classBinding,
true )。
- 执行 ! classEnv.CreateImmutableBinding(classBinding,
- 令 outerPrivateEnvironment 为
正在运行的执行上下文 的 PrivateEnvironment。 - 令 classPrivateEnvironment 为
NewPrivateEnvironment (outerPrivateEnvironment)。 - 如果
ClassBody 存在，则- 对于
ClassBody 的PrivateBoundIdentifiers 中的每个 String dn，执行- 如果 classPrivateEnvironment.[[Names]]
包含一个
Private Name pn 使得 pn.[[Description]] 是 dn，则断言 ：这只可能发生在 getter/setter 对。
- 否则，
- 令 name 为一个新的
Private Name ，其 [[Description]] 是 dn。 - 将 name 追加到 classPrivateEnvironment.[[Names]]。
- 令 name 为一个新的
- 如果 classPrivateEnvironment.[[Names]]
包含一个
- 对于
- 如果
ClassHeritage 不存在，则- 令 protoParent 为
%Object.prototype% 。 - 令 constructorParent 为
%Function.prototype% 。
- 令 protoParent 为
- 否则，
- 设置
正在运行的执行上下文 的 LexicalEnvironment 为 classEnv。 - 注释：当求值
ClassHeritage 时，正在运行的执行上下文 的 PrivateEnvironment 是 outerPrivateEnvironment。 - 令 superclassRef 为
Completion (ClassHeritage 的Evaluation )。 - 设置
正在运行的执行上下文 的 LexicalEnvironment 为 env。 - 令 superclass 为 ?
GetValue (? superclassRef)。 - 如果 superclass 是
null ，则- 令 protoParent 为
null 。 - 令 constructorParent 为
%Function.prototype% 。
- 令 protoParent 为
- 否则，如果
IsConstructor (superclass) 是false ，则- 抛出
TypeError 异常。
- 抛出
- 否则，
- 设置
- 令 proto 为
OrdinaryObjectCreate (protoParent)。 - 如果
ClassBody 不存在，令 constructor 为empty 。 - 否则，令 constructor 为
ClassBody 的ConstructorMethod 。 - 设置
正在运行的执行上下文 的 LexicalEnvironment 为 classEnv。 - 设置
正在运行的执行上下文 的 PrivateEnvironment 为 classPrivateEnvironment。 - 如果 constructor 是
empty ，则- 令 defaultConstructor 为一个新的
抽象闭包 ，不接受参数，不捕获任何值，调用时执行以下步骤：- 令 args 为通过 [[Call]] 或 [[Construct]] 传递给此函数的参数
List 。 - 如果 NewTarget 是
undefined ，抛出TypeError 异常。 - 令 F 为
活跃函数对象 。 - 如果 F.[[ConstructorKind]] 是
derived ，则- 注释：此分支的行为类似于
constructor(...args) { super(...args); }。最显著的区别是，虽然前述ECMAScript 源文本 会可观察地调用%Array.prototype%上的%Symbol.iterator% 方法，但此函数不会。 - 令 func 为 ! F.[[GetPrototypeOf]]()。
- 如果
IsConstructor (func) 是false ，抛出TypeError 异常。 - 令 result 为 ?
Construct (func, args, NewTarget)。
- 注释：此分支的行为类似于
- 否则，
- 注释：此分支的行为类似于
constructor() {}。 - 令 result 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Object.prototype%" )。
- 注释：此分支的行为类似于
- 执行 ?
InitializeInstanceElements (result, F)。 - 返回 result。
- 令 args 为通过 [[Call]] 或 [[Construct]] 传递给此函数的参数
- 令 F 为
CreateBuiltinFunction (defaultConstructor, 0, className, « [[ConstructorKind]], [[SourceText]] »,当前 Realm Record , constructorParent)。
- 令 defaultConstructor 为一个新的
- 否则，
- 令 constructorInfo 为 ! constructor 的
DefineMethod ，参数为 proto 和 constructorParent。 - 令 F 为 constructorInfo.[[Closure]]。
- 执行
MakeClassConstructor (F)。 - 执行
SetFunctionName (F, className)。
- 令 constructorInfo 为 ! constructor 的
- 执行
MakeConstructor (F,false , proto)。 - 如果
ClassHeritage 存在，设置 F.[[ConstructorKind]] 为derived 。 - 执行 !
DefineMethodProperty (proto,"constructor" , F,false )。 - 如果
ClassBody 不存在，令 elements 为一个新的空List 。 - 否则，令 elements 为
ClassBody 的NonConstructorElements 。 - 令 instancePrivateMethods 为一个新的空
List 。 - 令 staticPrivateMethods 为一个新的空
List 。 - 令 instanceFields 为一个新的空
List 。 - 令 staticElements 为一个新的空
List 。 - 对于 elements 中的每个
ClassElement e，执行- 如果 e 的
IsStatic 是false ，则- 令 element 为
Completion (e 的ClassElementEvaluation ，参数为 proto)。
- 令 element 为
- 否则，
- 令 element 为
Completion (e 的ClassElementEvaluation ，参数为 F)。
- 令 element 为
- 如果 element 是一个
突然完成 ，则- 设置
正在运行的执行上下文 的 LexicalEnvironment 为 env。 - 设置
正在运行的执行上下文 的 PrivateEnvironment 为 outerPrivateEnvironment。 - 返回 ? element。
- 设置
- 设置 element 为 ! element。
- 如果 element 是一个
PrivateElement ，则断言 ：element.[[Kind]] 是method 或accessor 。- 如果 e 的
IsStatic 是false ，令 container 为 instancePrivateMethods。 - 否则，令 container 为 staticPrivateMethods。
- 如果 container 包含一个
PrivateElement pe 使得 pe.[[Key]] 是 element.[[Key]]，则断言 ：element.[[Kind]] 和 pe.[[Kind]] 都是accessor 。- 如果 element.[[Get]] 是
undefined ，则- 令 combined 为
PrivateElement { [[Key]]: element.[[Key]], [[Kind]]:accessor , [[Get]]: pe.[[Get]], [[Set]]: element.[[Set]] }。
- 令 combined 为
- 否则，
- 令 combined 为
PrivateElement { [[Key]]: element.[[Key]], [[Kind]]:accessor , [[Get]]: element.[[Get]], [[Set]]: pe.[[Set]] }。
- 令 combined 为
- 在 container 中将 pe 替换为 combined。
- 否则，
- 将 element 追加到 container。
- 否则，如果 element 是一个
ClassFieldDefinition Record ，则- 如果 e 的
IsStatic 是false ，将 element 追加到 instanceFields。 - 否则，将 element 追加到 staticElements。
- 如果 e 的
- 否则，如果 element 是一个
ClassStaticBlockDefinition Record ，则- 将 element 追加到 staticElements。
- 如果 e 的
- 设置
正在运行的执行上下文 的 LexicalEnvironment 为 env。 - 如果 classBinding 不是
undefined ，则- 执行 ! classEnv.InitializeBinding(classBinding, F)。
- 设置 F.[[PrivateMethods]] 为 instancePrivateMethods。
- 设置 F.[[Fields]] 为 instanceFields。
- 对于 staticPrivateMethods 中的每个
PrivateElement method，执行- 执行 !
PrivateMethodOrAccessorAdd (F, method)。
- 执行 !
- 对于 staticElements 中的每个元素 elementRecord，执行
- 如果 elementRecord 是一个
ClassFieldDefinition Record ，则- 令 result 为
Completion (DefineField (F, elementRecord))。
- 令 result 为
- 否则，
断言 ：elementRecord 是一个ClassStaticBlockDefinition Record 。- 令 result 为
Completion (Call (elementRecord.[[BodyFunction]], F))。
- 如果 result 是一个
突然完成 ，则- 设置
正在运行的执行上下文 的 PrivateEnvironment 为 outerPrivateEnvironment。 - 返回 ? result。
- 设置
- 如果 elementRecord 是一个
- 设置
正在运行的执行上下文 的 PrivateEnvironment 为 outerPrivateEnvironment。 - 返回 F。
15.7.15 运行时语义：BindingClassDeclarationEvaluation
- 令 className 为
BindingIdentifier 的StringValue 。 - 令 value 为 ?
ClassTail 的ClassDefinitionEvaluation ，参数为 className 和 className。 - 设置 value.[[SourceText]] 为
ClassDeclaration 匹配的源文本 。 - 令 env 为
正在运行的执行上下文 的 LexicalEnvironment。 - 执行 ?
InitializeBoundName (className, value, env)。 - 返回 value。
- 令 value 为 ?
ClassTail 的ClassDefinitionEvaluation ，参数为undefined 和"default" 。 - 设置 value.[[SourceText]] 为
ClassDeclaration 匹配的源文本 。 - 返回 value。
15.7.16 运行时语义：Evaluation
- 执行 ? 此
ClassDeclaration 的BindingClassDeclarationEvaluation 。 - 返回
empty 。
- 令 value 为 ?
ClassTail 的ClassDefinitionEvaluation ，参数为undefined 和"" 。 - 设置 value.[[SourceText]] 为
ClassExpression 匹配的源文本 。 - 返回 value。
- 令 className 为
BindingIdentifier 的StringValue 。 - 令 value 为 ?
ClassTail 的ClassDefinitionEvaluation ，参数为 className 和 className。 - 设置 value.[[SourceText]] 为
ClassExpression 匹配的源文本 。 - 返回 value。
- 令 privateIdentifier 为
PrivateIdentifier 的StringValue 。 - 令 privateEnvRec 为
正在运行的执行上下文 的 PrivateEnvironment。 - 令 names 为 privateEnvRec.[[Names]]。
断言 ：names 中恰好有一个元素是Private Name ，其 [[Description]] 是 privateIdentifier。- 令 privateName 为 names 中 [[Description]] 是
privateIdentifier 的
Private Name 。 - 返回 privateName。
- 返回
undefined 。
15.8 异步函数定义
语法
当存在 [Await] 参数时，await 被解析为
- 在
AsyncFunctionBody 中。 - 在
AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 或AsyncGeneratorExpression 的FormalParameters 中。此位置的AwaitExpression 通过静态语义 是语法错误。 - 在
Module 中。
当 await 可能被解析为标识符。这包括以下上下文：
与
15.8.1 静态语义：早期错误
- 如果
AsyncFunctionBody 的FunctionBodyContainsUseStrict 是true 且UniqueFormalParameters 的IsSimpleParameterList 是false ，则是语法错误。 - 如果
AsyncMethod 的HasDirectSuper 是true ，则是语法错误。 - 如果
UniqueFormalParameters Contains AwaitExpression 是true ，则是语法错误。 - 如果
UniqueFormalParameters 的BoundNames 的任何元素也出现在AsyncFunctionBody 的LexicallyDeclaredNames 中，则是语法错误。
- 如果
AsyncFunctionBody 的FunctionBodyContainsUseStrict 是true 且FormalParameters 的IsSimpleParameterList 是false ，则是语法错误。 - 如果
FormalParameters Contains AwaitExpression 是true ，则是语法错误。 - 如果
IsStrict (FormalParameters ) 是true ，则应用UniqueFormalParameters : FormalParameters - 如果
BindingIdentifier 存在且IsStrict (BindingIdentifier ) 是true ，如果BindingIdentifier 的StringValue 是"eval" 或"arguments" ，则是语法错误。 - 如果
FormalParameters 的BoundNames 的任何元素也出现在AsyncFunctionBody 的LexicallyDeclaredNames 中，则是语法错误。 - 如果
FormalParameters Contains SuperProperty 是true ，则是语法错误。 - 如果
AsyncFunctionBody Contains SuperProperty 是true ，则是语法错误。 - 如果
FormalParameters Contains SuperCall 是true ，则是语法错误。 - 如果
AsyncFunctionBody Contains SuperCall 是true ，则是语法错误。
15.8.2 运行时语义：InstantiateAsyncFunctionObject
- 令 name 为
BindingIdentifier 的StringValue 。 - 令 sourceText 为
AsyncFunctionDeclaration 匹配的源文本 。 - 令 F 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F, name)。 - 返回 F。
- 令 sourceText 为
AsyncFunctionDeclaration 匹配的源文本 。 - 令 F 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F,"default" )。 - 返回 F。
15.8.3 运行时语义：InstantiateAsyncFunctionExpression
- 如果 name 不存在，设置 name 为
"" 。 - 令 env 为
正在运行的执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
正在运行的执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
AsyncFunctionExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 返回 closure。
断言 ：name 不存在。- 设置 name 为
BindingIdentifier 的StringValue 。 - 令 outerEnv 为
正在运行的执行上下文 的 LexicalEnvironment。 - 令 funcEnv 为
NewDeclarativeEnvironment (outerEnv)。 - 执行 ! funcEnv.CreateImmutableBinding(name,
false )。 - 令 privateEnv 为
正在运行的执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
AsyncFunctionExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , funcEnv, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 执行 ! funcEnv.InitializeBinding(name, closure)。
- 返回 closure。
15.8.4 运行时语义：EvaluateAsyncFunctionBody
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 completion 为
Completion (FunctionDeclarationInstantiation (functionObject, argumentsList))。 - 如果 completion 是一个
突然完成 ，则- 执行 !
Call (promiseCapability.[[Reject]],undefined , « completion.[[Value]] »)。
- 执行 !
- 否则，
- 执行
AsyncFunctionStart (promiseCapability,FunctionBody )。
- 执行
- 返回
ReturnCompletion (promiseCapability.[[Promise]])。
15.8.5 运行时语义：Evaluation
- 令 exprRef 为 ?
UnaryExpression 的Evaluation 。 - 令 value 为 ?
GetValue (exprRef)。 - 返回 ?
Await (value)。
15.9 异步箭头函数定义
语法
补充语法
当处理产生式实例
时，使用以下语法来细化对
15.9.1 静态语义：早期错误
- 如果
AsyncArrowBindingIdentifier 的BoundNames 的任何元素也出现在AsyncConciseBody 的LexicallyDeclaredNames 中，则是语法错误。
CoverCallExpressionAndAsyncArrowHead 必须覆盖 一个AsyncArrowHead 。- 如果
CoverCallExpressionAndAsyncArrowHead Contains YieldExpression 是true ，则是语法错误。 - 如果
CoverCallExpressionAndAsyncArrowHead Contains AwaitExpression 是true ，则是语法错误。 - 如果
CoverCallExpressionAndAsyncArrowHead 的BoundNames 的任何元素也出现在AsyncConciseBody 的LexicallyDeclaredNames 中，则是语法错误。 - 如果
AsyncConciseBody 的AsyncConciseBodyContainsUseStrict 是true 且CoverCallExpressionAndAsyncArrowHead 的IsSimpleParameterList 是false ，则是语法错误。
15.9.2 静态语义：AsyncConciseBodyContainsUseStrict
- 返回
false 。
15.9.3 运行时语义：EvaluateAsyncConciseBody
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 completion 为
Completion (FunctionDeclarationInstantiation (functionObject, argumentsList))。 - 如果 completion 是一个
突然完成 ，则- 执行 !
Call (promiseCapability.[[Reject]],undefined , « completion.[[Value]] »)。
- 执行 !
- 否则，
- 执行
AsyncFunctionStart (promiseCapability,ExpressionBody )。
- 执行
- 返回
ReturnCompletion (promiseCapability.[[Promise]])。
15.9.4 运行时语义：InstantiateAsyncArrowFunctionExpression
- 如果 name 不存在，设置 name 为
"" 。 - 令 env 为
正在运行的执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
正在运行的执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
AsyncArrowFunction 匹配的源文本 。 - 令 parameters 为
AsyncArrowBindingIdentifier 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText, parameters,AsyncConciseBody ,lexical-this , env, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 返回 closure。
- 如果 name 不存在，设置 name 为
"" 。 - 令 env 为
正在运行的执行上下文 的 LexicalEnvironment。 - 令 privateEnv 为
正在运行的执行上下文 的 PrivateEnvironment。 - 令 sourceText 为
AsyncArrowFunction 匹配的源文本 。 - 令 head 为被
CoverCallExpressionAndAsyncArrowHead 覆盖 的AsyncArrowHead 。 - 令 parameters 为 head 的
ArrowFormalParameters 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText, parameters,AsyncConciseBody ,lexical-this , env, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 返回 closure。
15.9.5 运行时语义：Evaluation
15.10 尾位置调用
15.10.1 静态语义：IsInTailPosition ( call )
抽象操作 IsInTailPosition 接受参数 call（一个
- 如果
IsStrict (call) 是false ，返回false 。 - 如果 call 不包含在
FunctionBody 、ConciseBody 或AsyncConciseBody 中，返回false 。 - 令 body 为最紧密包含 call 的
FunctionBody 、ConciseBody 或AsyncConciseBody 。 - 如果 body 是
GeneratorBody 的FunctionBody ，返回false 。 - 如果 body 是
AsyncFunctionBody 的FunctionBody ，返回false 。 - 如果 body 是
AsyncGeneratorBody 的FunctionBody ，返回false 。 - 如果 body 是
AsyncConciseBody ，返回false 。 - 返回 body 以参数 call 进行的
HasCallInTailPosition 的结果。
15.10.2 静态语义：HasCallInTailPosition
紧接着返回调用结果的
它按以下产生式分段定义：
- 令 has 为
StatementList 以参数 call 进行的HasCallInTailPosition 。 - 如果 has 是
true ，返回true 。 - 返回
StatementListItem 以参数 call 进行的HasCallInTailPosition 。
- 返回
false 。
- 令 has 为第一个
Statement 以参数 call 进行的HasCallInTailPosition 。 - 如果 has 是
true ，返回true 。 - 返回第二个
Statement 以参数 call 进行的HasCallInTailPosition 。
- 返回
Statement 以参数 call 进行的HasCallInTailPosition 。
- 返回
LabelledItem 以参数 call 进行的HasCallInTailPosition 。
- 返回
Expression 以参数 call 进行的HasCallInTailPosition 。
- 返回
CaseBlock 以参数 call 进行的HasCallInTailPosition 。
- 令 has 为
false 。 - 如果存在第一个
CaseClauses ，将 has 设置为第一个CaseClauses 以参数 call 进行的HasCallInTailPosition 。 - 如果 has 是
true ，返回true 。 - 将 has 设置为
DefaultClause 以参数 call 进行的HasCallInTailPosition 。 - 如果 has 是
true ，返回true 。 - 如果存在第二个
CaseClauses ，将 has 设置为第二个CaseClauses 以参数 call 进行的HasCallInTailPosition 。 - 返回 has。
- 令 has 为
CaseClauses 以参数 call 进行的HasCallInTailPosition 。 - 如果 has 是
true ，返回true 。 - 返回
CaseClause 以参数 call 进行的HasCallInTailPosition 。
- 如果存在
StatementList ，返回StatementList 以参数 call 进行的HasCallInTailPosition 。 - 返回
false 。
- 返回
Catch 以参数 call 进行的HasCallInTailPosition 。
- 返回
Finally 以参数 call 进行的HasCallInTailPosition 。
- 返回
Block 以参数 call 进行的HasCallInTailPosition 。
- 返回
false 。
- 返回
AssignmentExpression 以参数 call 进行的HasCallInTailPosition 。
- 令 has 为第一个
AssignmentExpression 以参数 call 进行的HasCallInTailPosition 。 - 如果 has 是
true ，返回true 。 - 返回第二个
AssignmentExpression 以参数 call 进行的HasCallInTailPosition 。
- 返回
BitwiseORExpression 以参数 call 进行的HasCallInTailPosition 。
- 返回
LogicalANDExpression 以参数 call 进行的HasCallInTailPosition 。
- 返回
BitwiseORExpression 以参数 call 进行的HasCallInTailPosition 。
- 如果此
CallExpression 是 call，返回true 。 - 返回
false 。
- 返回
OptionalChain 以参数 call 进行的HasCallInTailPosition 。
- 返回
false 。
- 如果此
OptionalChain 是 call，返回true 。 - 返回
false 。
- 如果此
MemberExpression 是 call，返回true 。 - 返回
false 。
- 令 expr 为被
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ParenthesizedExpression 。 - 返回 expr 以参数 call 进行的
HasCallInTailPosition 。
- 返回
Expression 以参数 call 进行的HasCallInTailPosition 。
15.10.3 PrepareForTailCall ( )
抽象操作 PrepareForTailCall 不接受参数，返回
尾位置调用必须在调用目标函数之前释放与当前执行函数
例如，尾位置调用应该仅按目标函数的激活记录大小超出调用函数激活记录大小的量来增长实现的激活记录栈。如果目标函数的激活记录更小，则栈的总大小应该减少。
16 ECMAScript 语言：脚本和模块
16.1 脚本
语法
16.1.1 静态语义：早期错误
-
如果
ScriptBody 的LexicallyDeclaredNames 包含任何重复项，则是语法错误。 -
如果
ScriptBody 的LexicallyDeclaredNames 的任何元素也出现在ScriptBody 的VarDeclaredNames 中，则是语法错误。
-
如果
StatementList Contains super，则是语法错误，除非包含super的源文本是由直接 eval 处理的 eval 代码。直接 eval 中super的附加早期错误 规则在19.2.1.1 中定义。 -
如果
StatementList Contains NewTarget ，则是语法错误，除非包含NewTarget 的源文本是由直接 eval 处理的 eval 代码。直接 eval 中NewTarget 的附加早期错误 规则在19.2.1.1 中定义。 -
如果
StatementList 以参数 « » 进行的ContainsDuplicateLabels 是true ，则是语法错误。 -
如果
StatementList 以参数 « » 进行的ContainsUndefinedBreakTarget 是true ，则是语法错误。 -
如果
StatementList 以参数 « » 和 « » 进行的ContainsUndefinedContinueTarget 是true ，则是语法错误。 -
如果
StatementList 以参数 « » 进行的AllPrivateIdentifiersValid 是false ，则是语法错误，除非包含ScriptBody 的源文本是由直接 eval 处理的 eval 代码。
16.1.2 静态语义：ScriptIsStrict
- 如果
ScriptBody 存在且ScriptBody 的指令序言 包含一个Use Strict 指令 ，返回true ；否则，返回false 。
16.1.3 运行时语义：Evaluation
- 返回
undefined 。
16.1.4 脚本记录
脚本记录 封装了关于被求值脚本的信息。每个脚本记录包含
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[Realm]] |
一个 |
创建此脚本的 |
| [[ECMAScriptCode]] |
一个 |
解析此脚本源文本的结果。 |
| [[LoadedModules]] |
一个 |
从此脚本导入的说明符字符串到已解析的 |
| [[HostDefined]] |
任何东西（默认值是 |
为需要将附加信息与脚本关联的 |
16.1.5 ParseScript ( sourceText, realm, hostDefined )
抽象操作 ParseScript 接受参数 sourceText（
实现可以在对该脚本源文本执行 ParseScript 之前解析脚本源文本并分析其早期错误条件。但是，任何错误的报告必须推迟到本规范实际对该源文本执行 ParseScript 的时候。
16.1.6 ScriptEvaluation ( scriptRecord )
抽象操作 ScriptEvaluation 接受参数 scriptRecord（一个
- 令 globalEnv 为 scriptRecord.[[Realm]].[[GlobalEnv]]。
- 令 scriptContext 为一个新的
ECMAScript 代码执行上下文 。 - 设置 scriptContext 的 Function 为
null 。 - 设置 scriptContext 的
Realm 为 scriptRecord.[[Realm]]。 - 设置 scriptContext 的 ScriptOrModule 为 scriptRecord。
- 设置 scriptContext 的 VariableEnvironment 为 globalEnv。
- 设置 scriptContext 的 LexicalEnvironment 为 globalEnv。
- 设置 scriptContext 的 PrivateEnvironment 为
null 。 - 挂起
正在运行的执行上下文 。 - 将 scriptContext 推入
执行上下文栈 ；scriptContext 现在是正在运行的执行上下文 。 - 令 script 为 scriptRecord.[[ECMAScriptCode]]。
- 令 result 为
Completion (GlobalDeclarationInstantiation (script, globalEnv))。 - 如果 result 是一个
正常完成 ，则- 设置 result 为
Completion (script 的Evaluation )。 - 如果 result 是一个
正常完成 且 result.[[Value]] 是empty ，则- 设置 result 为
NormalCompletion (undefined )。
- 设置 result 为
- 设置 result 为
- 挂起 scriptContext 并将其从
执行上下文栈 中移除。 断言 ：执行上下文栈 不为空。- 恢复现在位于
执行上下文栈 顶部的上下文作为正在运行的执行上下文 。 - 返回 ? result。
16.1.7 GlobalDeclarationInstantiation ( script, env )
抽象操作 GlobalDeclarationInstantiation 接受参数 script（一个
当为求值脚本建立
调用时执行以下步骤：
- 令 lexNames 为 script 的
LexicallyDeclaredNames 。 - 令 varNames 为 script 的
VarDeclaredNames 。 - 对于 lexNames 的每个元素 name，执行
- 如果
HasLexicalDeclaration (env, name) 是true ，抛出一个SyntaxError 异常。 - 令 hasRestrictedGlobal 为 ?
HasRestrictedGlobalProperty (env, name)。 - 注释：全局
var和function绑定（除了由非严格直接 eval 引入的那些）是不可配置的，因此是受限制的全局属性。 - 如果 hasRestrictedGlobal 是
true ，抛出一个SyntaxError 异常。
- 如果
- 对于 varNames 的每个元素 name，执行
- 如果
HasLexicalDeclaration (env, name) 是true ，抛出一个SyntaxError 异常。
- 如果
- 令 varDeclarations 为 script 的
VarScopedDeclarations 。 - 令 functionsToInitialize 为一个新的空
List 。 - 令 declaredFunctionNames 为一个新的空
List 。 - 对于 varDeclarations 的每个元素 d，按反向
List 顺序，执行- 如果 d 不是
VariableDeclaration 、ForBinding 或BindingIdentifier ，则断言 ：d 是FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration 。- 注释：如果同一个名称有多个函数声明，使用最后的声明。
- 令 fn 为 d 的
BoundNames 的唯一元素。 - 如果 declaredFunctionNames 不包含 fn，则
- 令 fnDefinable 为 ?
CanDeclareGlobalFunction (env, fn)。 - 如果 fnDefinable 是
false ，抛出一个TypeError 异常。 - 将 fn 追加到 declaredFunctionNames。
- 将 d 作为 functionsToInitialize 的第一个元素插入。
- 令 fnDefinable 为 ?
- 如果 d 不是
- 令 declaredVarNames 为一个新的空
List 。 - 对于 varDeclarations 的每个元素 d，执行
- 如果 d 是
VariableDeclaration 、ForBinding 或BindingIdentifier ，则- 对于 d 的
BoundNames 的每个字符串 vn，执行- 如果 declaredFunctionNames 不包含 vn，则
- 令 vnDefinable 为 ?
CanDeclareGlobalVar (env, vn)。 - 如果 vnDefinable 是
false ，抛出一个TypeError 异常。 - 如果 declaredVarNames 不包含 vn，则
- 将 vn 追加到 declaredVarNames。
- 令 vnDefinable 为 ?
- 如果 declaredFunctionNames 不包含 vn，则
- 对于 d 的
- 如果 d 是
- 注释：如果
全局对象 是一个普通对象 ，则在此算法步骤之后不会发生异常终止。但是，如果全局对象 是一个Proxy 异质对象 ，它可能表现出在以下某些步骤中导致异常终止的行为。 - 注释：附录
B.3.2.2 在此处添加了附加步骤。 - 令 lexDeclarations 为 script 的
LexicallyScopedDeclarations 。 - 令 privateEnv 为
null 。 - 对于 lexDeclarations 的每个元素 d，执行
- 注释：词法声明的名称仅在此处实例化但不初始化。
- 对于 d 的
BoundNames 的每个元素 dn，执行- 如果 d 的
IsConstantDeclaration 是true ，则- 执行 ? env.CreateImmutableBinding(dn,
true )。
- 执行 ? env.CreateImmutableBinding(dn,
- 否则，
- 执行 ? env.CreateMutableBinding(dn,
false )。
- 执行 ? env.CreateMutableBinding(dn,
- 如果 d 的
- 对于 functionsToInitialize 的每个
解析节点 f，执行- 令 fn 为 f 的
BoundNames 的唯一元素。 - 令 fo 为 f 以参数 env 和 privateEnv 进行的
InstantiateFunctionObject 。 - 执行 ?
CreateGlobalFunctionBinding (env, fn, fo,false )。
- 令 fn 为 f 的
- 对于 declaredVarNames 的每个字符串 vn，执行
- 执行 ?
CreateGlobalVarBinding (env, vn,false )。
- 执行 ?
- 返回
unused 。
与显式的 var 或 function 声明不同，直接在
16.2 模块
语法
16.2.1 模块语义
16.2.1.1 静态语义：早期错误
-
如果
ModuleItemList 的LexicallyDeclaredNames 包含任何重复条目，则是语法错误。 -
如果
ModuleItemList 的LexicallyDeclaredNames 中的任何元素也出现在ModuleItemList 的VarDeclaredNames 中，则是语法错误。 -
如果
ModuleItemList 的ExportedNames 包含任何重复条目，则是语法错误。 -
如果
ModuleItemList 的ExportedBindings 中的任何元素既不出现在ModuleItemList 的VarDeclaredNames 中，也不出现在ModuleItemList 的LexicallyDeclaredNames 中，则是语法错误。 -
如果
ModuleItemList Contains super，则是语法错误。 -
如果
ModuleItemList Contains NewTarget ，则是语法错误。 -
如果
ModuleItemList 的ContainsDuplicateLabels 以参数 « » 的结果是true ，则是语法错误。 -
如果
ModuleItemList 的ContainsUndefinedBreakTarget 以参数 « » 的结果是true ，则是语法错误。 -
如果
ModuleItemList 的ContainsUndefinedContinueTarget 以参数 « » 和 « » 的结果是true ，则是语法错误。 -
如果
ModuleItemList 的AllPrivateIdentifiersValid 以参数 « » 的结果是false ，则是语法错误。
重复 export default
- 如果
IsStringWellFormedUnicode (SV ofStringLiteral ) 是false ，则是语法错误。
16.2.1.2 静态语义：ImportedLocalNames ( importEntries )
抽象操作 ImportedLocalNames 接受参数 importEntries（一个
- 让 localNames 为一个新的空
List 。 - 对于 importEntries 的每个
ImportEntry Record i，执行- 将 i.[[LocalName]] 追加到 localNames。
- 返回 localNames。
16.2.1.3 ModuleRequest 记录
ModuleRequest Record 表示带有给定导入属性的模块导入请求。它由以下字段组成：
| 字段名称 | 值类型 | 含义 |
|---|---|---|
| [[Specifier]] | 一个字符串 | 模块说明符 |
| [[Attributes]] |
一个 |
导入属性 |
LoadedModuleRequest Record 表示模块导入请求以及结果
| 字段名称 | 值类型 | 含义 |
|---|---|---|
| [[Specifier]] | 一个字符串 | 模块说明符 |
| [[Attributes]] |
一个 |
导入属性 |
| [[Module]] |
一个 |
与此模块请求对应的已加载模块 |
ImportAttribute Record 由以下字段组成：
| 字段名称 | 值类型 | 含义 |
|---|---|---|
| [[Key]] | 一个字符串 | 属性键 |
| [[Value]] | 一个字符串 | 属性值 |
16.2.1.3.1 ModuleRequestsEqual ( left, right )
抽象操作 ModuleRequestsEqual 接受参数 left（一个
- 如果 left.[[Specifier]] 不是
right.[[Specifier]]，返回
false 。 - 让 leftAttrs 为 left.[[Attributes]]。
- 让 rightAttrs 为 right.[[Attributes]]。
- 让 leftAttrsCount 为 leftAttrs 中元素的数量。
- 让 rightAttrsCount 为 rightAttrs 中元素的数量。
- 如果 leftAttrsCount ≠ rightAttrsCount，返回
false 。 - 对于 leftAttrs 的每个
ImportAttribute Record l，执行- 如果 rightAttrs 不包含一个
ImportAttribute Record r 使得 l.[[Key]] 是 r.[[Key]] 且 l.[[Value]] 是 r.[[Value]]，返回false 。
- 如果 rightAttrs 不包含一个
- 返回
true 。
16.2.1.4 静态语义：ModuleRequests
- 返回一个新的空
List 。
- 返回
ModuleItem 的ModuleRequests 。
- 让 requests 为
ModuleItemList 的ModuleRequests 。 - 让 additionalRequests 为
ModuleItem 的ModuleRequests 。 - 对于 additionalRequests 的每个
ModuleRequest Record mr，执行- 如果 requests 不包含一个
ModuleRequest Record mr2 使得ModuleRequestsEqual (mr, mr2) 是true ，那么- 将 mr 追加到 requests。
- 如果 requests 不包含一个
- 返回 requests。
- 返回一个新的空
List 。
- 让 specifier 为
FromClause 的SV 。 - 返回一个
List ，其唯一元素是ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » }。
- 让 specifier 为
FromClause 的SV 。 - 让 attributes 为
WithClause 的WithClauseToAttributes 。 - 返回一个
List ，其唯一元素是ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attributes }。
- 让 specifier 为
ModuleSpecifier 的SV 。 - 返回一个
List ，其唯一元素是ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » }。
- 让 specifier 为
ModuleSpecifier 的SV 。 - 让 attributes 为
WithClause 的WithClauseToAttributes 。 - 返回一个
List ，其唯一元素是ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attributes }。
- 让 specifier 为
FromClause 的SV 。 - 返回一个
List ，其唯一元素是ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » }。
- 让 specifier 为
FromClause 的SV 。 - 让 attributes 为
WithClause 的WithClauseToAttributes 。 - 返回一个
List ，其唯一元素是ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attributes }。
- 返回一个新的空
List 。
16.2.1.5 抽象模块记录
Module Record 封装了单个模块的导入和导出的结构信息。此信息用于链接连接模块集合的导入和导出。Module Record 包含四个仅在求值模块时使用的字段。
出于规范目的，Module Record 值是
Module Record 定义了
| 字段名称 | 值类型 | 含义 |
|---|---|---|
| [[Realm]] |
一个 |
创建此模块的 |
| [[Environment]] |
一个 |
包含此模块顶级绑定的 |
| [[Namespace]] |
一个对象或 |
如果为此模块创建了模块命名空间对象（ |
| [[HostDefined]] |
任何内容（默认值为 |
为需要将附加信息与模块关联的 |
| 方法 | 目的 |
|---|---|
| LoadRequestedModules([hostDefined]) |
通过递归加载所有依赖项为链接准备模块，并返回一个 promise。 |
| GetExportedNames([exportStarSet]) |
返回从此模块直接或间接导出的所有名称的列表。 在调用此方法之前，LoadRequestedModules 必须已成功完成。 |
| ResolveExport(exportName [, resolveSet]) |
返回此模块导出的名称的绑定。绑定由 ResolvedBinding
Record 表示，形式为 { [[Module]]:
每次使用特定的 exportName、resolveSet 对作为参数调用此操作时，必须返回相同的结果。 在调用此方法之前，LoadRequestedModules 必须已成功完成。 |
| Link() |
通过传递性地解析所有模块依赖项并创建 在调用此方法之前，LoadRequestedModules 必须已成功完成。 |
| Evaluate() |
返回用于此模块及其依赖项求值的 promise，在成功求值或已成功求值时解析，在求值错误或已求值失败时拒绝。如果 promise
被拒绝，期望 在调用此方法之前，Link 必须已成功完成。 |
16.2.1.5.1 EvaluateModuleSync ( module )
抽象操作 EvaluateModuleSync 接受参数 module（一个
断言 ： module 不是Cyclic Module Record 。- 让 promise 为 module.Evaluate()。
断言 ： promise.[[PromiseState]] 是fulfilled 或rejected 。- 如果 promise.[[PromiseState]] 是
rejected ，那么- 如果 promise.[[PromiseIsHandled]] 是
false ，执行HostPromiseRejectionTracker (promise,"handle" )。 - 设置 promise.[[PromiseIsHandled]] 为
true 。 - 返回
ThrowCompletion (promise.[[PromiseResult]])。
- 如果 promise.[[PromiseIsHandled]] 是
- 返回
unused 。
16.2.1.6 循环模块记录
Cyclic Module
Record 用于表示可以与
除了
| 字段名称 | 值类型 | 含义 |
|---|---|---|
| [[Status]] |
|
初始为 |
| [[EvaluationError]] |
一个 |
表示求值期间发生的异常的 |
| [[DFSIndex]] |
一个 |
仅在 Link 和 Evaluate 期间使用的辅助字段。如果 [[Status]] 是
|
| [[DFSAncestorIndex]] |
一个 |
仅在 Link 和 Evaluate 期间使用的辅助字段。如果 [[Status]] 是
|
| [[RequestedModules]] |
|
与此模块中的导入关联的 |
| [[LoadedModules]] |
|
从此记录表示的模块用于请求导入具有相对导入属性的模块的说明符字符串到已解析的 |
| [[CycleRoot]] |
一个 |
循环的第一个访问模块，强连通分量的根 DFS 祖先。对于不在循环中的模块，这将是模块本身。一旦 Evaluate 完成，模块的 [[DFSAncestorIndex]] 是其 [[CycleRoot]] 的 [[DFSIndex]]。 |
| [[HasTLA]] | 一个布尔值 |
此模块是否单独异步（例如，如果它是包含顶级等待的 |
| [[AsyncEvaluationOrder]] |
|
此字段初始设置为 |
| [[TopLevelCapability]] |
一个 |
如果此模块是某个循环的 [[CycleRoot]]，并且在该循环中的某个模块上调用了
Evaluate()，此字段包含该整个求值的 |
| [[AsyncParentModules]] |
|
如果此模块或依赖项的 [[HasTLA]] 为
|
| [[PendingAsyncDependencies]] |
一个 |
如果此模块有任何异步依赖项，这会跟踪此模块剩余要执行的异步依赖模块数量。 当此字段达到 0 且没有执行错误时，具有异步依赖项的模块将被执行。 |
除了
| 方法 | 目的 |
|---|---|
| InitializeEnvironment() |
初始化模块的 |
| ExecuteModule([promiseCapability]) |
在其 |
GraphLoadingState Record 是一个
| 字段名称 | 值类型 | 含义 |
|---|---|---|
| [[PromiseCapability]] |
一个 |
加载过程完成时要解析的 promise。 |
| [[IsLoading]] | 一个布尔值 | 如果加载过程尚未完成，无论是成功还是出现错误，它都是 true。 |
| [[PendingModulesCount]] |
一个非负 |
它跟踪待处理的 |
| [[Visited]] |
|
它是当前加载过程已加载的 |
| [[HostDefined]] |
任何内容（默认值为 |
它包含从 LoadRequestedModules 调用者传递到 |
16.2.1.6.1 Module Record 抽象方法的实现
以下是
16.2.1.6.1.1 LoadRequestedModules ( [ hostDefined ] )
- 如果 hostDefined 不存在，让 hostDefined 为
empty 。 - 让 pc 为 !
NewPromiseCapability (%Promise% )。 - 让 state 为
GraphLoadingState Record { [[IsLoading]]:true ，[[PendingModulesCount]]: 1，[[Visited]]: « »，[[PromiseCapability]]: pc，[[HostDefined]]: hostDefined }。 - 执行
InnerModuleLoading (state, module)。 - 返回 pc.[[Promise]]。
<link rel="preload" as="..."> 标签设置正确的 fetch 目标。
import() 表达式从不设置 hostDefined
参数。
16.2.1.6.1.1.1 InnerModuleLoading ( state, module )
抽象操作 InnerModuleLoading 接受参数 state（一个
断言 ：state.[[IsLoading]] 是true 。- 如果 module 是
Cyclic Module Record ，module.[[Status]] 是new ，并且 state.[[Visited]] 不包含 module，那么- 将 module 追加到 state.[[Visited]]。
- 让 requestedModulesCount 为 module.[[RequestedModules]] 中的元素数量。
- 设置 state.[[PendingModulesCount]] 为 state.[[PendingModulesCount]] + requestedModulesCount。
- 对于 module.[[RequestedModules]] 的每个
ModuleRequest Record request，执行- 如果
AllImportAttributesSupported (request.[[Attributes]]) 是false ，那么- 让 error 为
ThrowCompletion （一个新创建的SyntaxError 对象）。 - 执行
ContinueModuleLoading (state, error)。
- 让 error 为
- 否则，如果 module.[[LoadedModules]] 包含一个
LoadedModuleRequest Record record，使得ModuleRequestsEqual (record, request) 是true ，那么- 执行
InnerModuleLoading (state, record.[[Module]])。
- 执行
- 否则，
- 执行
HostLoadImportedModule (module, request, state.[[HostDefined]], state)。 - 注意：
HostLoadImportedModule 将调用FinishLoadingImportedModule ， 它通过ContinueModuleLoading 重新进入图加载过程。
- 执行
- 如果 state.[[IsLoading]] 是
false ，返回unused 。
- 如果
断言 ：state.[[PendingModulesCount]] ≥ 1。- 设置 state.[[PendingModulesCount]] 为 state.[[PendingModulesCount]] - 1。
- 如果 state.[[PendingModulesCount]] =
0，那么
- 设置 state.[[IsLoading]] 为
false 。 - 对于 state.[[Visited]] 的每个
Cyclic Module Record loaded，执行- 如果 loaded.[[Status]]
是
new ，设置 loaded.[[Status]] 为unlinked 。
- 如果 loaded.[[Status]]
是
- 执行 !
Call (state.[[PromiseCapability]].[[Resolve]],undefined , «undefined »)。
- 设置 state.[[IsLoading]] 为
- 返回
unused 。
16.2.1.6.1.1.2 ContinueModuleLoading ( state, moduleCompletion )
抽象操作 ContinueModuleLoading 接受参数 state（一个
- 如果 state.[[IsLoading]] 是
false ，返回unused 。 - 如果 moduleCompletion 是
正常 完成 ，那么- 执行
InnerModuleLoading (state, moduleCompletion.[[Value]])。
- 执行
- 否则，
- 设置 state.[[IsLoading]] 为
false 。 - 执行 !
Call (state.[[PromiseCapability]].[[Reject]],undefined , « moduleCompletion.[[Value]] »)。
- 设置 state.[[IsLoading]] 为
- 返回
unused 。
16.2.1.6.1.2 Link ( )
断言 ：module.[[Status]] 是unlinked 、linked 、evaluating-async 或evaluated 之一。- 让 stack 为一个新的空
List 。 - 让 result 为
Completion (InnerModuleLinking (module, stack, 0))。 - 如果 result 是
突然完成 ，那么- 对于 stack 的每个
Cyclic Module Record m，执行断言 ： m.[[Status]] 是linking 。- 设置 m.[[Status]] 为
unlinked 。
断言 ：module.[[Status]] 是unlinked 。- 返回 ? result。
- 对于 stack 的每个
断言 ：module.[[Status]] 是linked 、evaluating-async 或evaluated 之一。断言 ：stack 是空的。- 返回
unused 。
16.2.1.6.1.2.1 InnerModuleLinking ( module, stack, index )
抽象操作 InnerModuleLinking 接受参数 module（一个
- 如果 module 不是
Cyclic Module Record ，那么- 执行 ? module.Link()。
- 返回 index。
- 如果 module.[[Status]] 是
linking 、linked 、evaluating-async 或evaluated 之一，那么- 返回 index。
断言 ：module.[[Status]] 是unlinked 。- 设置 module.[[Status]] 为
linking 。 - 设置 module.[[DFSIndex]] 为 index。
- 设置 module.[[DFSAncestorIndex]] 为 index。
- 设置 index 为 index + 1。
- 将 module 追加到 stack。
- 对于 module.[[RequestedModules]] 的每个
ModuleRequest Record request，执行- 让 requiredModule 为
GetImportedModule (module, request)。 - 设置 index 为 ?
InnerModuleLinking (requiredModule, stack, index)。 - 如果 requiredModule 是
Cyclic Module Record ，那么
- 让 requiredModule 为
- 执行 ? module.InitializeEnvironment()。
断言 ：module 在 stack 中恰好出现一次。断言 ：module.[[DFSAncestorIndex]] ≤ module.[[DFSIndex]]。- 如果 module.[[DFSAncestorIndex]] =
module.[[DFSIndex]]，那么
- 让 done 为
false 。 - 重复，当 done 是
false 时，- 让 requiredModule 为 stack 的最后一个元素。
- 移除 stack 的最后一个元素。
断言 ： requiredModule 是Cyclic Module Record 。- 设置 requiredModule.[[Status]] 为
linked 。 - 如果 requiredModule 和 module 是同一个
Module Record ，设置 done 为true 。
- 让 done 为
- 返回 index。
16.2.1.6.1.3 Evaluate ( )
断言 ：此次 Evaluate 调用不会与surrounding agent 内的另一次 Evaluate 调用同时发生。断言 ：module.[[Status]] 是linked 、evaluating-async 或evaluated 之一。- 如果 module.[[Status]] 是
evaluating-async 或evaluated ， 设置 module 为 module.[[CycleRoot]]。 - 如果 module.[[TopLevelCapability]] 不是
empty ，那么- 返回 module.[[TopLevelCapability]].[[Promise]]。
- 让 stack 为一个新的空
List 。 - 让 capability 为 !
NewPromiseCapability (%Promise% )。 - 设置 module.[[TopLevelCapability]] 为 capability。
- 让 result 为
Completion (InnerModuleEvaluation (module, stack, 0))。 - 如果 result 是
突然完成 ，那么- 对于 stack 的每个
Cyclic Module Record m，执行 断言 ：module.[[Status]] 是evaluated 。断言 ：module.[[EvaluationError]] 和 result 是相同的Completion Record 。- 执行 !
Call (capability.[[Reject]],undefined , « result.[[Value]] »)。
- 对于 stack 的每个
- 否则，
- 返回 capability.[[Promise]]。
16.2.1.6.1.3.1 InnerModuleEvaluation ( module, stack, index )
抽象操作 InnerModuleEvaluation 接受参数 module（一个
- 如果 module 不是
Cyclic Module Record ，那么- 执行 ?
EvaluateModuleSync (module)。 - 返回 index。
- 执行 ?
- 如果 module.[[Status]] 是
evaluating-async 或evaluated ，那么- 如果 module.[[EvaluationError]] 是
empty ，返回 index。 - 否则，返回 ? module.[[EvaluationError]]。
- 如果 module.[[EvaluationError]] 是
- 如果 module.[[Status]] 是
evaluating ，返回 index。 断言 ：module.[[Status]] 是linked 。- 设置 module.[[Status]] 为
evaluating 。 - 设置 module.[[DFSIndex]] 为 index。
- 设置 module.[[DFSAncestorIndex]] 为 index。
- 设置 module.[[PendingAsyncDependencies]] 为 0。
- 设置 index 为 index + 1。
- 将 module 追加到 stack。
- 对于 module.[[RequestedModules]] 的每个
ModuleRequest Record request，执行- 让 requiredModule 为
GetImportedModule (module, request)。 - 设置 index 为 ?
InnerModuleEvaluation (requiredModule, stack, index)。 - 如果 requiredModule 是
Cyclic Module Record ，那么断言 ： requiredModule.[[Status]] 是evaluating 、evaluating-async 或evaluated 之一。断言 ： requiredModule.[[Status]] 是evaluating 当且仅当 stack 包含 requiredModule。- 如果 requiredModule.[[Status]] 是
evaluating ，那么- 设置 module.[[DFSAncestorIndex]] 为
min (module.[[DFSAncestorIndex]], requiredModule.[[DFSAncestorIndex]])。
- 设置 module.[[DFSAncestorIndex]] 为
- 否则，
- 设置 requiredModule 为 requiredModule.[[CycleRoot]]。
断言 ： requiredModule.[[Status]] 是evaluating-async 或evaluated 。- 如果 requiredModule.[[EvaluationError]] 不是
empty ，返回 ? requiredModule.[[EvaluationError]]。
- 如果 requiredModule.[[AsyncEvaluationOrder]] 是
整数 ，那么- 设置 module.[[PendingAsyncDependencies]] 为 module.[[PendingAsyncDependencies]] + 1。
- 将 module 追加到 requiredModule.[[AsyncParentModules]]。
- 让 requiredModule 为
- 如果 module.[[PendingAsyncDependencies]] > 0 或
module.[[HasTLA]] 是
true ，那么断言 ： module.[[AsyncEvaluationOrder]] 是unset 。- 设置 module.[[AsyncEvaluationOrder]] 为
IncrementModuleAsyncEvaluationCount ()。 - 如果 module.[[PendingAsyncDependencies]] = 0，
执行
ExecuteAsyncModule (module)。
- 否则，
- 执行 ? module.ExecuteModule()。
断言 ：module 在 stack 中恰好出现一次。断言 ：module.[[DFSAncestorIndex]] ≤ module.[[DFSIndex]]。- 如果 module.[[DFSAncestorIndex]] =
module.[[DFSIndex]]，那么
- 让 done 为
false 。 - 重复，当 done 是
false 时，- 让 requiredModule 为 stack 的最后一个元素。
- 移除 stack 的最后一个元素。
断言 ： requiredModule 是Cyclic Module Record 。断言 ： requiredModule.[[AsyncEvaluationOrder]] 是整数 或unset 。- 如果 requiredModule.[[AsyncEvaluationOrder]] 是
unset ，设置 requiredModule.[[Status]] 为evaluated 。 - 否则，设置 requiredModule.[[Status]] 为
evaluating-async 。 - 如果 requiredModule 和 module 是同一个
Module Record ，设置 done 为true 。 - 设置 requiredModule.[[CycleRoot]] 为 module。
- 让 done 为
- 返回 index。
模块在被 InnerModuleEvaluation 遍历时处于
当异步循环不是
16.2.1.6.1.3.2 ExecuteAsyncModule ( module )
抽象操作 ExecuteAsyncModule 接受参数 module（一个
断言 ：module.[[Status]] 是evaluating 或evaluating-async 。断言 ：module.[[HasTLA]] 是true 。- 让 capability 为 !
NewPromiseCapability (%Promise% )。 - 让 fulfilledClosure 为一个新的
Abstract Closure ， 不接受参数，捕获 module，并在调用时执行以下步骤：- 执行
AsyncModuleExecutionFulfilled (module)。 - 返回
undefined 。
- 执行
- 让 onFulfilled 为
CreateBuiltinFunction (fulfilledClosure, 0,"" , « »)。 - 让 rejectedClosure 为一个新的
Abstract Closure ， 接受参数 (error)，捕获 module，并在调用时执行以下步骤：- 执行
AsyncModuleExecutionRejected (module, error)。 - 返回
undefined 。
- 执行
- 让 onRejected 为
CreateBuiltinFunction (rejectedClosure, 0,"" , « »)。 - 执行
PerformPromiseThen (capability.[[Promise]], onFulfilled, onRejected)。 - 执行 ! module.ExecuteModule(capability)。
- 返回
unused 。
16.2.1.6.1.3.3 GatherAvailableAncestors ( module, execList )
抽象操作 GatherAvailableAncestors 接受参数 module
（一个
- 对于 module.[[AsyncParentModules]] 的每个
Cyclic Module Record m，执行- 如果 execList 不包含 m 且
m.[[CycleRoot]].[[EvaluationError]] 是
empty ，那么断言 ： m.[[Status]] 是evaluating-async 。断言 ： m.[[EvaluationError]] 是empty 。断言 ： m.[[AsyncEvaluationOrder]] 是整数 。断言 ： m.[[PendingAsyncDependencies]] > 0。- 设置 m.[[PendingAsyncDependencies]] 为 m.[[PendingAsyncDependencies]] - 1。
- 如果 m.[[PendingAsyncDependencies]] =
0，那么
- 将 m 追加到 execList。
- 如果 m.[[HasTLA]] 是
false ，执行GatherAvailableAncestors (m, execList)。
- 如果 execList 不包含 m 且
m.[[CycleRoot]].[[EvaluationError]] 是
- 返回
unused 。
当根 module 的异步执行完成时，此函数确定能够在此完成时同步执行的模块列表，将它们填充到 execList 中。
16.2.1.6.1.3.4 AsyncModuleExecutionFulfilled ( module )
抽象操作 AsyncModuleExecutionFulfilled 接受参数
module（一个
- 如果 module.[[Status]] 是
evaluated ，那么断言 ： module.[[EvaluationError]] 不是empty 。- 返回
unused 。
断言 ：module.[[Status]] 是evaluating-async 。断言 ：module.[[AsyncEvaluationOrder]] 是整数 。断言 ：module.[[EvaluationError]] 是empty 。- 设置 module.[[AsyncEvaluationOrder]]
为
done 。 - 设置 module.[[Status]] 为
evaluated 。 - 如果 module.[[TopLevelCapability]] 不是
empty ，那么断言 ： module.[[CycleRoot]] 和 module 是同一个Module Record 。- 执行 !
Call (module.[[TopLevelCapability]].[[Resolve]],undefined , «undefined »)。
- 让 execList 为一个新的空
List 。 - 执行
GatherAvailableAncestors (module, execList)。 断言 ：execList 的所有元素都将其 [[AsyncEvaluationOrder]] 字段设置为整数 ，[[PendingAsyncDependencies]] 字段设置为 0，[[EvaluationError]] 字段设置为empty 。- 让 sortedExecList 为一个
List ， 其元素是 execList 的元素，按其 [[AsyncEvaluationOrder]] 字段升序排序。 - 对于 sortedExecList 的每个
Cyclic Module Record m，执行- 如果 m.[[Status]] 是
evaluated ，那么断言 ： m.[[EvaluationError]] 不是empty 。
- 否则，如果 m.[[HasTLA]] 是
true ，那么- 执行
ExecuteAsyncModule (m)。
- 执行
- 否则，
- 让 result 为 m.ExecuteModule()。
- 如果 result 是
突然完成 ，那么- 执行
AsyncModuleExecutionRejected (m, result.[[Value]])。
- 执行
- 否则，
- 设置 m.[[AsyncEvaluationOrder]]
为
done 。 - 设置 m.[[Status]] 为
evaluated 。 - 如果 m.[[TopLevelCapability]]
不是
empty ，那么断言 ： m.[[CycleRoot]] 和 m 是同一个Module Record 。- 执行 !
Call (m.[[TopLevelCapability]].[[Resolve]],undefined , «undefined »)。
- 设置 m.[[AsyncEvaluationOrder]]
为
- 如果 m.[[Status]] 是
- 返回
unused 。
16.2.1.6.1.3.5 AsyncModuleExecutionRejected ( module, error )
抽象操作 AsyncModuleExecutionRejected 接受参数
module（一个
- 如果 module.[[Status]] 是
evaluated ，那么断言 ： module.[[EvaluationError]] 不是empty 。- 返回
unused 。
断言 ：module.[[Status]] 是evaluating-async 。断言 ：module.[[AsyncEvaluationOrder]] 是整数 。断言 ：module.[[EvaluationError]] 是empty 。- 设置 module.[[EvaluationError]] 为
ThrowCompletion (error)。 - 设置 module.[[Status]] 为
evaluated 。 - 设置 module.[[AsyncEvaluationOrder]]
为
done 。 - 注意：module.[[AsyncEvaluationOrder]]
设置为
done 是为了与AsyncModuleExecutionFulfilled 保持对称。 在InnerModuleEvaluation 中， 当模块的 [[EvaluationError]] 内部槽不是empty 时，其 [[AsyncEvaluationOrder]] 内部槽的值未被使用。 - 对于 module.[[AsyncParentModules]] 的每个
Cyclic Module Record m，执行- 执行
AsyncModuleExecutionRejected (m, error)。
- 执行
- 如果 module.[[TopLevelCapability]] 不是
empty ，那么断言 ： module.[[CycleRoot]] 和 module 是同一个Module Record 。- 执行 !
Call (module.[[TopLevelCapability]].[[Reject]],undefined , « error »)。
- 返回
unused 。
16.2.1.6.2 循环模块记录图示例
这个非规范性章节提供了一系列常见模块图链接和求值的示例，特别关注错误如何发生。
首先考虑以下简单的模块图：
让我们首先假设没有错误条件。当
然后考虑在成功调用 A.LoadRequestedModules() 后涉及链接错误的情况。如果 C 的
最后，考虑在成功调用 Link() 后涉及求值错误的情况。如果 C 的
现在考虑一种不同类型的错误条件：
在这种情况下，模块 A 声明对某个其他模块的依赖，但该模块不存在
这里加载、链接和求值错误之间的差异是由于以下特征：
求值 必须只执行一次，因为它可能导致副作用；因此记住求值是否已经执行很重要，即使不成功。（在错误情况下，记住异常也是有意义的，因为否则后续的 Evaluate() 调用将必须合成一个新的异常。）- 另一方面，链接是无副作用的，因此即使失败，也可以稍后重试而不会有问题。
- 加载与
宿主 密切交互，对于其中一些，可能希望允许用户重试失败的加载（例如，如果失败是由临时不良网络条件引起的）。
现在，考虑一个有循环的模块图：
这里我们假设入口点是模块 A，因此
然后
在成功情况下，循环模块图的求值阶段也发生类似的故事。
现在考虑 A 有链接错误的情况；例如，它尝试从 C 导入一个不存在的绑定。在这种情况下，上述步骤仍然发生，包括从第二次对
A 调用
或者，考虑 A 有求值错误的情况；例如，它的源代码抛出异常。在这种情况下，上述步骤的求值时类似仍然发生，包括从第二次对 A 调用
await
的模块，通过
最后，考虑一个有循环的模块图，其中所有模块都异步完成：
加载和链接像之前一样发生，所有模块最终的 [[Status]] 设置为
调用 A.Evaluate() 对 A、B 和 D 调用
|
字段
|
A | B | C | D | E |
|---|---|---|---|---|---|
| [[DFSIndex]] | 0 | 1 | 3 | 2 | 4 |
| [[DFSAncestorIndex]] | 0 | 0 | 0 | 0 | 4 |
| [[Status]] | |||||
| [[AsyncEvaluationOrder]] | 4 | 1 | 3 | 0 | 2 |
| [[AsyncParentModules]] | « » | « A » | « A » | « B, C » | « C » |
| [[PendingAsyncDependencies]] | 2（B 和 C） | 1（D） | 2（D 和 E） | 0 | 0 |
让我们假设 E 首先完成执行。当发生这种情况时，调用
|
字段
|
C | E |
|---|---|---|
| [[DFSIndex]] | 3 | 4 |
| [[DFSAncestorIndex]] | 0 | 4 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 3 | 2 |
| [[AsyncParentModules]] | « A » | « C » |
| [[PendingAsyncDependencies]] | 1（D） | 0 |
D 接下来完成（因为它是唯一仍在执行的模块）。当发生这种情况时，再次调用 await，可能与 B 并行）。更新模块的字段如
|
字段
|
B | C | D |
|---|---|---|---|
| [[DFSIndex]] | 1 | 3 | 2 |
| [[DFSAncestorIndex]] | 0 | 0 | 0 |
| [[Status]] | |||
| [[AsyncEvaluationOrder]] | 1 | 3 | 0 |
| [[AsyncParentModules]] | « A » | « A » | « B, C » |
| [[PendingAsyncDependencies]] | 0 | 0 | 0 |
让我们假设 C 接下来完成执行。当发生这种情况时，再次调用
|
字段
|
A | C |
|---|---|---|
| [[DFSIndex]] | 0 | 3 |
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | 3 |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 1（B） | 0 |
然后，B 完成执行。当发生这种情况时，再次调用
|
字段
|
A | B |
|---|---|---|
| [[DFSIndex]] | 0 | 1 |
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | 1 |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 0 | 0 |
最后，A 完成执行。当发生这种情况时，再次调用
|
字段
|
A |
|---|---|
| [[DFSIndex]] | 0 |
| [[DFSAncestorIndex]] | 0 |
| [[Status]] | |
| [[AsyncEvaluationOrder]] | 4 |
| [[AsyncParentModules]] | « » |
| [[PendingAsyncDependencies]] | 0 |
或者，考虑失败情况，其中 C 在 B 完成执行之前执行失败并返回错误。当发生这种情况时，调用
|
字段
|
A | C |
|---|---|---|
| [[DFSIndex]] | 0 | 3 |
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | 3 |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 1（B） | 0 |
| [[EvaluationError]] | C 的求值错误 |
A 将被拒绝，错误与 C 相同，因为 C 将用 C 的错误对 A
调用
|
字段
|
A |
|---|---|
| [[DFSIndex]] | 0 |
| [[DFSAncestorIndex]] | 0 |
| [[Status]] | |
| [[AsyncEvaluationOrder]] | 4 |
| [[AsyncParentModules]] | « » |
| [[PendingAsyncDependencies]] | 0 |
| [[EvaluationError]] | C 的 |
然后，B 完成执行且没有错误。当发生这种情况时，再次调用
|
字段
|
A | B |
|---|---|---|
| [[DFSIndex]] | 0 | 1 |
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | 1 |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 0 | 0 |
| [[EvaluationError]] | C 的 |
16.2.1.7 源文本模块记录
源文本模块记录用于表示从使用
除了在
| 字段名称 | 值类型 | 含义 |
|---|---|---|
| [[ECMAScriptCode]] |
一个 |
使用 |
| [[Context]] |
一个 |
与此模块关联的 |
| [[ImportMeta]] |
一个对象或 |
通过 import.meta 元属性暴露的对象。在被 ECMAScript 代码访问之前为
|
| [[ImportEntries]] |
一个 |
从此模块代码派生的 ImportEntry 记录的 |
| [[LocalExportEntries]] |
一个 |
从此模块代码派生的 ExportEntry 记录的 |
| [[IndirectExportEntries]] |
一个 |
从此模块代码派生的 ExportEntry 记录的 export * as namespace 声明的导出。
|
| [[StarExportEntries]] |
一个 |
从此模块代码派生的 ExportEntry 记录的 export * 声明，不包括 export * as namespace 声明。
|
ImportEntry
记录是一个
| 字段名称 | 值类型 | 含义 |
|---|---|---|
| [[ModuleRequest]] |
一个 |
表示 |
| [[ImportName]] |
一个字符串或 |
由 [[ModuleRequest]] 标识的模块导出所需绑定的名称。值
|
| [[LocalName]] | 一个字符串 | 用于从导入模块内部本地访问导入值的名称。 |
| 导入语句形式 | [[ModuleRequest]] | [[ImportName]] | [[LocalName]] |
|---|---|---|---|
import v from "mod";
|
|
|
|
import * as ns from "mod";
|
|
|
|
import {x} from "mod";
|
|
|
|
import {x as v} from "mod";
|
|
|
|
import "mod";
|
不创建 |
||
ExportEntry
记录是一个
| 字段名称 | 值类型 | 含义 |
|---|---|---|
| [[ExportName]] |
一个字符串或 |
此模块用于导出此绑定的名称。 |
| [[ModuleRequest]] |
一个 |
表示 |
| [[ImportName]] |
一个字符串、 |
由 [[ModuleRequest]] 标识的模块导出所需绑定的名称。
如果 export * as ns from "mod" 声明。
export * from "mod" 声明。
|
| [[LocalName]] |
一个字符串或 |
用于从导入模块内部本地访问导出值的名称。如果导出值在模块内部不可本地访问，则为 |
| 导出语句形式 | [[ExportName]] | [[ModuleRequest]] | [[ImportName]] | [[LocalName]] |
|---|---|---|---|---|
export var v;
|
|
|
|
|
export default function f() {}
|
|
|
|
|
export default function () {}
|
|
|
|
|
export default 42;
|
|
|
|
|
export {x};
|
|
|
|
|
export {v as x};
|
|
|
|
|
export {x} from "mod";
|
|
|
|
|
export {v as x} from "mod";
|
|
|
|
|
export * from "mod";
|
|
|
|
|
export * as ns from "mod";
|
|
|
|
|
以下定义指定了
16.2.1.7.1 ParseModule ( sourceText, realm, hostDefined )
抽象操作 ParseModule 接受参数 sourceText（
- 设 body 为
ParseText (sourceText,Module )。 - 如果 body 是一个错误的
列表 ，返回 body。 - 设 requestedModules 为 body 的
ModuleRequests 。 - 设 importEntries 为 body 的
ImportEntries 。 - 设 importedBoundNames 为
ImportedLocalNames (importEntries)。 - 设 indirectExportEntries 为一个新的空
列表 。 - 设 localExportEntries 为一个新的空
列表 。 - 设 starExportEntries 为一个新的空
列表 。 - 设 exportEntries 为 body 的
ExportEntries 。 - 对于 exportEntries 中的每个
ExportEntry Record ee，执行- 如果 ee.[[ModuleRequest]] 是
null ，那么- 如果 importedBoundNames 不包含
ee.[[LocalName]]，那么
- 将 ee 附加到 localExportEntries。
- 否则，
- 设 ie 为 importEntries 中 [[LocalName]] 是 ee.[[LocalName]] 的元素。
- 如果 ie.[[ImportName]]
是
namespace-object ，那么- 注：这是对导入模块命名空间对象的重新导出。
- 将 ee 附加到 localExportEntries。
- 否则，
- 注：这是对单个名称的重新导出。
- 将
ExportEntry Record { [[ModuleRequest]]: ie.[[ModuleRequest]], [[ImportName]]: ie.[[ImportName]], [[LocalName]]:null , [[ExportName]]: ee.[[ExportName]] } 附加到 indirectExportEntries。
- 如果 importedBoundNames 不包含
ee.[[LocalName]]，那么
- 否则如果 ee.[[ImportName]] 是
all-but-default ，那么断言 ：ee.[[ExportName]] 是null 。- 将 ee 附加到 starExportEntries。
- 否则，
- 将 ee 附加到 indirectExportEntries。
- 如果 ee.[[ModuleRequest]] 是
- 设 async 为 body
Contains await。 - 返回
源文本模块记录 { [[Realm]]: realm, [[Environment]]:empty , [[Namespace]]:empty , [[CycleRoot]]:empty , [[HasTLA]]: async, [[AsyncEvaluationOrder]]:unset , [[TopLevelCapability]]:empty , [[AsyncParentModules]]: « », [[PendingAsyncDependencies]]:empty , [[Status]]:new , [[EvaluationError]]:empty , [[HostDefined]]: hostDefined, [[ECMAScriptCode]]: body, [[Context]]:empty , [[ImportMeta]]:empty , [[RequestedModules]]: requestedModules, [[LoadedModules]]: « », [[ImportEntries]]: importEntries, [[LocalExportEntries]]: localExportEntries, [[IndirectExportEntries]]: indirectExportEntries, [[StarExportEntries]]: starExportEntries, [[DFSIndex]]:empty , [[DFSAncestorIndex]]:empty }。
实现可能在对该模块源文本求值 ParseModule 之前解析模块源文本并分析其早期错误条件。然而，任何错误的报告都必须推迟到本规范实际对该源文本执行 ParseModule 的时刻。
16.2.1.7.2 模块记录抽象方法的实现
以下是
16.2.1.7.2.1 GetExportedNames ( [ exportStarSet ] )
断言 ：module.[[Status]] 不是new 。- 如果 exportStarSet 不存在，设 exportStarSet 为一个新的空
列表 。 - 如果 exportStarSet 包含 module，那么
- 将 module 附加到 exportStarSet。
- 设 exportedNames 为一个新的空
列表 。 - 对于 module.[[LocalExportEntries]] 中的每个
ExportEntry Record e，执行 - 对于 module.[[IndirectExportEntries]] 中的每个
ExportEntry Record e，执行 - 对于 module.[[StarExportEntries]] 中的每个
ExportEntry Record e，执行断言 ：e.[[ModuleRequest]] 不是null 。- 设 requestedModule 为
GetImportedModule (module, e.[[ModuleRequest]])。 - 设 starNames 为 requestedModule.GetExportedNames(exportStarSet)。
- 对于 starNames 的每个元素 n，执行
- 如果 n 不是
"default" ，那么- 如果 exportedNames 不包含
n，那么
- 将 n 附加到 exportedNames。
- 如果 exportedNames 不包含
n，那么
- 如果 n 不是
- 返回 exportedNames。
GetExportedNames 不会过滤掉或为具有歧义星号导出绑定的名称抛出异常。
16.2.1.7.2.2 ResolveExport ( exportName [ , resolveSet ] )
ResolveExport 尝试将导入绑定解析为实际的定义模块和本地绑定名称。定义模块可能是调用此方法的
如果找到定义模块，返回一个
调用时执行以下步骤：
断言 ：module.[[Status]] 不是new 。- 如果 resolveSet 不存在，设 resolveSet 为一个新的空
列表 。 - 对于 resolveSet 中的每个
记录 { [[Module]], [[ExportName]] } r，执行 - 将
记录 { [[Module]]: module, [[ExportName]]: exportName } 附加到 resolveSet。 - 对于 module.[[LocalExportEntries]] 中的每个
ExportEntry Record e，执行- 如果 e.[[ExportName]] 是
exportName，那么
断言 ： module 为此导出提供直接绑定。- 返回
ResolvedBinding Record { [[Module]]: module, [[BindingName]]: e.[[LocalName]] }。
- 如果 e.[[ExportName]] 是
exportName，那么
- 对于 module.[[IndirectExportEntries]] 中的每个
ExportEntry Record e，执行- 如果 e.[[ExportName]] 是
exportName，那么
断言 ： e.[[ModuleRequest]] 不是null 。- 设 importedModule 为
GetImportedModule (module, e.[[ModuleRequest]])。 - 如果 e.[[ImportName]] 是
all ，那么断言 ： module 不为此导出提供直接绑定。- 返回
ResolvedBinding Record { [[Module]]: importedModule, [[BindingName]]:namespace }。
- 否则，
- 如果 e.[[ExportName]] 是
exportName，那么
- 如果 exportName 是
"default" ，那么断言 ：此模块没有显式定义default导出。- 返回
null 。 - 注：
default导出不能由export * from "mod"声明提供。
- 设 starResolution 为
null 。 - 对于 module.[[StarExportEntries]] 中的每个
ExportEntry Record e，执行断言 ：e.[[ModuleRequest]] 不是null 。- 设 importedModule 为
GetImportedModule (module, e.[[ModuleRequest]])。 - 设 resolution 为 importedModule.ResolveExport(exportName, resolveSet)。
- 如果 resolution 是
ambiguous ，返回ambiguous 。 - 如果 resolution 不是
null ，那么断言 ： resolution 是一个ResolvedBinding Record 。- 如果 starResolution 是
null ，那么- 设 starResolution 为 resolution。
- 否则，
断言 ：有多个包含请求名称的*导入。- 如果 resolution.[[Module]] 和
starResolution.[[Module]] 不是同一个
模块记录 ，返回ambiguous 。 - 如果 resolution.[[BindingName]] 不是
starResolution.[[BindingName]] 且
resolution.[[BindingName]] 或
starResolution.[[BindingName]] 中的任一个是
namespace ，返回ambiguous 。 - 如果 resolution.[[BindingName]]
是一个字符串 ， starResolution.[[BindingName]]是一个字符串 ，且 resolution.[[BindingName]] 不是 starResolution.[[BindingName]]，返回ambiguous 。
- 返回 starResolution。
16.2.1.7.3 循环模块记录抽象方法的实现
以下是
16.2.1.7.3.1 InitializeEnvironment ( )
- 对于 module.[[IndirectExportEntries]] 中的每个
ExportEntry Record e，执行断言 ：e.[[ExportName]] 不是null 。- 设 resolution 为 module.ResolveExport(e.[[ExportName]])。
- 如果 resolution 是
null 或ambiguous ，抛出SyntaxError 异常。 断言 ：resolution 是一个ResolvedBinding Record 。
断言 ：module 的所有命名导出都是可解析的。- 设 realm 为 module.[[Realm]]。
断言 ：realm 不是undefined 。- 设 env 为
NewModuleEnvironment (realm.[[GlobalEnv]])。 - 设 module.[[Environment]] 为 env。
- 对于 module.[[ImportEntries]] 中的每个
ImportEntry Record in，执行- 设 importedModule 为
GetImportedModule (module, in.[[ModuleRequest]])。 - 如果 in.[[ImportName]] 是
namespace-object ，那么- 设 namespace 为
GetModuleNamespace (importedModule)。 - 执行
! env.CreateImmutableBinding(in.[[LocalName]],
true )。 - 执行 ! env.InitializeBinding(in.[[LocalName]], namespace)。
- 设 namespace 为
- 否则，
- 设 resolution 为 importedModule.ResolveExport(in.[[ImportName]])。
- 如果 resolution 是
null 或ambiguous ，抛出SyntaxError 异常。 - 如果 resolution.[[BindingName]] 是
namespace ，那么- 设 namespace 为
GetModuleNamespace (resolution.[[Module]])。 - 执行
! env.CreateImmutableBinding(in.[[LocalName]],
true )。 - 执行 ! env.InitializeBinding(in.[[LocalName]], namespace)。
- 设 namespace 为
- 否则，
- 执行
CreateImportBinding (env, in.[[LocalName]], resolution.[[Module]], resolution.[[BindingName]])。
- 执行
- 设 importedModule 为
- 设 moduleContext 为一个新的
ECMAScript 代码执行上下文 。 - 设 moduleContext 的 Function 为
null 。 断言 ：module.[[Realm]] 不是undefined 。- 设 moduleContext 的
Realm 为 module.[[Realm]]。 - 设 moduleContext 的 ScriptOrModule 为 module。
- 设 moduleContext 的 VariableEnvironment 为 module.[[Environment]]。
- 设 moduleContext 的 LexicalEnvironment 为 module.[[Environment]]。
- 设 moduleContext 的 PrivateEnvironment 为
null 。 - 设 module.[[Context]] 为 moduleContext。
- 将 moduleContext 压入
执行上下文栈 ；moduleContext 现在是运行的执行上下文 。 - 设 code 为 module.[[ECMAScriptCode]]。
- 设 varDeclarations 为 code 的
VarScopedDeclarations 。 - 设 declaredVarNames 为一个新的空
列表 。 - 对于 varDeclarations 的每个元素 d，执行
- 对于 d 的
BoundNames 的每个元素 dn，执行- 如果 declaredVarNames 不包含
dn，那么
- 执行
! env.CreateMutableBinding(dn,
false )。 - 执行
! env.InitializeBinding(dn,
undefined )。 - 将 dn 附加到 declaredVarNames。
- 执行
! env.CreateMutableBinding(dn,
- 如果 declaredVarNames 不包含
dn，那么
- 对于 d 的
- 设 lexDeclarations 为 code 的
LexicallyScopedDeclarations 。 - 设 privateEnv 为
null 。 - 对于 lexDeclarations 的每个元素 d，执行
- 对于 d 的
BoundNames 的每个元素 dn，执行- 如果 d 的
IsConstantDeclaration 是true ，那么- 执行
! env.CreateImmutableBinding(dn,
true )。
- 执行
! env.CreateImmutableBinding(dn,
- 否则，
- 执行
! env.CreateMutableBinding(dn,
false )。
- 执行
! env.CreateMutableBinding(dn,
- 如果 d 是
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration ，那么- 设 fo 为 d 的
InstantiateFunctionObject ，参数为 env 和 privateEnv。 - 执行 ! env.InitializeBinding(dn, fo)。
- 设 fo 为 d 的
- 如果 d 的
- 对于 d 的
- 从
执行上下文栈 中移除 moduleContext。 - 返回
unused 。
16.2.1.7.3.2 ExecuteModule ( [ capability ] )
- 设 moduleContext 为一个新的
ECMAScript 代码执行上下文 。 - 设 moduleContext 的 Function 为
null 。 - 设 moduleContext 的
Realm 为 module.[[Realm]]。 - 设 moduleContext 的 ScriptOrModule 为 module。
断言 ：module 已被链接，其模块环境中的声明已被实例化。- 设 moduleContext 的 VariableEnvironment 为 module.[[Environment]]。
- 设 moduleContext 的 LexicalEnvironment 为 module.[[Environment]]。
- 暂停
运行的执行上下文 。 - 如果 module.[[HasTLA]] 是
false ，那么断言 ：capability 不存在。- 将 moduleContext 压入
执行上下文栈 ；moduleContext 现在是运行的执行上下文 。 - 设 result 为
Completion (module.[[ECMAScriptCode]] 的Evaluation )。 - 暂停 moduleContext 并从
执行上下文栈 中移除它。 - 恢复现在位于
执行上下文栈 顶部的上下文作为运行的执行上下文 。 - 如果 result 是一个
异常完成 ，那么- 返回 ? result。
- 否则，
断言 ：capability 是一个PromiseCapability Record 。- 执行
AsyncBlockStart (capability, module.[[ECMAScriptCode]], moduleContext)。
- 返回
unused 。
16.2.1.8 合成模块记录
合成模块记录用于表示由规范定义的模块的信息。其导出名称在创建时静态定义，而其对应的值可以通过
除了
16.2.1.8.1 CreateDefaultExportSyntheticModule ( defaultExport )
抽象操作 CreateDefaultExportSyntheticModule 接受参数
defaultExport（一个
- 设 realm 为
当前 Realm Record 。 - 设 setDefaultExport 为一个新的
抽象闭包 ，参数为 (module)，捕获 defaultExport 并在调用时执行以下步骤：- 执行
SetSyntheticModuleExport (module,"default" , defaultExport)。 - 返回
NormalCompletion (unused )。
- 执行
- 返回
合成模块记录 { [[Realm]]: realm, [[Environment]]:empty , [[Namespace]]:empty , [[HostDefined]]:undefined , [[ExportNames]]: «"default" », [[EvaluationSteps]]: setDefaultExport }。
16.2.1.8.2 ParseJSONModule ( source )
抽象操作 ParseJSONModule 接受参数 source（一个字符串），返回
- 设 json 为 ?
ParseJSON (source)。 - 返回
CreateDefaultExportSyntheticModule (json)。
16.2.1.8.3 SetSyntheticModuleExport ( module, exportName, exportValue )
抽象操作 SetSyntheticModuleExport 接受参数 module（一个
16.2.1.8.4 模块记录抽象方法的实现
以下是
16.2.1.8.4.1 LoadRequestedModules ( )
- 返回 !
PromiseResolve (%Promise% ,undefined )。
16.2.1.8.4.2 GetExportedNames ( )
- 返回 module.[[ExportNames]]。
16.2.1.8.4.3 ResolveExport ( exportName )
- 如果 module.[[ExportNames]] 不包含
exportName，返回
null 。 - 返回
ResolvedBinding Record { [[Module]]: module, [[BindingName]]: exportName }。
16.2.1.8.4.4 Link ( )
- 设 realm 为 module.[[Realm]]。
- 设 env 为
NewModuleEnvironment (realm.[[GlobalEnv]])。 - 设 module.[[Environment]] 为 env。
- 对于 module.[[ExportNames]] 的每个字符串
exportName，执行
- 执行
! env.CreateMutableBinding(exportName,
false )。 - 执行
! env.InitializeBinding(exportName,
undefined )。
- 执行
! env.CreateMutableBinding(exportName,
- 返回
NormalCompletion (unused )。
16.2.1.8.4.5 Evaluate ( )
- 设 moduleContext 为一个新的
ECMAScript 代码执行上下文 。 - 设 moduleContext 的 Function 为
null 。 - 设 moduleContext 的
Realm 为 module.[[Realm]]。 - 设 moduleContext 的 ScriptOrModule 为 module。
- 设 moduleContext 的 VariableEnvironment 为 module.[[Environment]]。
- 设 moduleContext 的 LexicalEnvironment 为 module.[[Environment]]。
- 暂停
运行的执行上下文 。 - 将 moduleContext 压入
执行上下文栈 ；moduleContext 现在是运行的执行上下文 。 - 设 steps 为 module.[[EvaluationSteps]]。
- 设 result 为
Completion (steps(module))。 - 暂停 moduleContext 并从
执行上下文栈 中移除它。 - 恢复现在位于
执行上下文栈 顶部的上下文作为运行的执行上下文 。 - 设 pc 为 !
NewPromiseCapability (%Promise% )。 IfAbruptRejectPromise (result, pc)。- 执行 !
Call (pc.[[Resolve]],undefined , «undefined »)。 - 返回 pc.[[Promise]]。
16.2.1.9 GetImportedModule ( referrer, request )
抽象操作 GetImportedModule 接受参数 referrer（一个
- 设 records 为一个
列表 ，由 referrer.[[LoadedModules]] 中满足ModuleRequestsEqual (r, request) 为true 的每个LoadedModuleRequest Record r 组成。 断言 ： records 恰好有一个元素，因为在调用此抽象操作之前，LoadRequestedModules 已在 referrer 上成功完成。- 设 record 为 records 的唯一元素。
- 返回 record.[[Module]]。
16.2.1.10 HostLoadImportedModule ( referrer, moduleRequest, hostDefined, payload )
HostLoadImportedModule 的实现必须符合以下要求：
-
宿主环境 必须执行FinishLoadingImportedModule (referrer, moduleRequest, payload, result)，其中 result 是包含 已加载的模块记录 的正常完成或抛出完成 ，可以是同步或异步的。 -
如果此操作被多次调用，使用两个 (referrer, moduleRequest) 对，满足：
- 第一个 referrer 与第二个 referrer 相同；
ModuleRequestsEqual (第一个 moduleRequest, 第二个 moduleRequest) 为true ；
并且它执行
FinishLoadingImportedModule (referrer, moduleRequest, payload, result)，其中 result 是正常完成 ，那么它必须每次都用相同的 result 执行FinishLoadingImportedModule (referrer, moduleRequest, payload, result)。 -
如果 moduleRequest.[[Attributes]] 有一个条目 entry，使得 entry.[[Key]] 是
"type" 且 entry.[[Value]] 是"json" ，当宿主环境 执行FinishLoadingImportedModule (referrer, moduleRequest, payload, result) 时，result 必须是调用ParseJSONModule 返回的完成记录 或抛出完成 。 -
操作必须将 payload 视为要传递给
FinishLoadingImportedModule 的不透明值。
执行的实际过程是
16.2.1.11 FinishLoadingImportedModule ( referrer, moduleRequest, payload, result )
抽象操作 FinishLoadingImportedModule 接受参数 referrer（一个
- 如果 result 是
正常完成 ，那么- 如果 referrer.[[LoadedModules]] 包含一个
LoadedModuleRequest Record record，使得ModuleRequestsEqual (record, moduleRequest) 为true ，那么 - 否则，
- 将
LoadedModuleRequest Record { [[Specifier]]: moduleRequest.[[Specifier]], [[Attributes]]: moduleRequest.[[Attributes]], [[Module]]: result.[[Value]] } 附加到 referrer.[[LoadedModules]]。
- 将
- 如果 referrer.[[LoadedModules]] 包含一个
- 如果 payload 是
GraphLoadingState Record ，那么- 执行
ContinueModuleLoading (payload, result)。
- 执行
- 否则，
- 执行
ContinueDynamicImport (payload, result)。
- 执行
- 返回
unused 。
16.2.1.12 AllImportAttributesSupported ( attributes )
抽象操作 AllImportAttributesSupported 接受参数 attributes（一个包含
- 设 supported 为
HostGetSupportedImportAttributes ()。 - 对于 attributes 的每个
ImportAttribute Record attribute，执行- 如果 supported 不包含 attribute.[[Key]]，返回
false 。
- 如果 supported 不包含 attribute.[[Key]]，返回
- 返回
true 。
16.2.1.12.1 HostGetSupportedImportAttributes ( )
HostGetSupportedImportAttributes 的实现必须符合以下要求：
HostGetSupportedImportAttributes 的默认实现是返回一个新的空
16.2.1.13 GetModuleNamespace ( module )
抽象操作 GetModuleNamespace 接受参数 module（
断言 ：如果 module 是循环模块记录 ，那么 module.[[Status]] 不是new 或unlinked 。- 设 namespace 为 module.[[Namespace]]。
- 如果 namespace 是
empty ，那么- 设 exportedNames 为 module.GetExportedNames()。
- 设 unambiguousNames 为一个新的空
列表 。 - 对于 exportedNames 的每个元素 name，执行
- 设 resolution 为 module.ResolveExport(name)。
- 如果 resolution 是
ResolvedBinding Record ，将 name 附加到 unambiguousNames。
- 设 namespace 为
ModuleNamespaceCreate (module, unambiguousNames)。
- 返回 namespace。
GetModuleNamespace 永远不会抛出异常。相反，无法解析的名称在此时简单地从命名空间中排除。除非它们都是未在任何地方明确请求的歧义星号导出，否则稍后会导致真正的链接错误。
16.2.1.14 运行时语义：求值
- 返回
undefined 。
- 设 result 为
Completion (ModuleItemList 的求值 )。 - 如果 result 是
正常完成 且 result.[[Value]] 是empty ，那么- 返回
undefined 。
- 返回
- 返回 ? result。
- 设 sl 为 ?
ModuleItemList 的求值 。 - 设 s 为
Completion (ModuleItem 的求值 )。 - 返回 ?
UpdateEmpty (s, sl)。
- 返回
empty 。
16.2.2 导入
语法
16.2.2.1 静态语义：早期错误
-
如果
ImportDeclaration 的BoundNames 包含任何重复条目，这是一个语法错误。
-
如果
WithClause 的WithClauseToAttributes 有两个不同的条目 a 和 b，使得 a.[[Key]] 是 b.[[Key]]，这是一个语法错误。
16.2.2.2 静态语义：ImportEntries
- 返回一个新的空
列表 。
- 设 entries1 为
ModuleItemList 的ImportEntries 。 - 设 entries2 为
ModuleItem 的ImportEntries 。 - 返回 entries1 和 entries2 的
列表连接 。
- 返回一个新的空
列表 。
- 设 module 为
ImportDeclaration 的ModuleRequests 的唯一元素。 - 返回
ImportClause 以参数 module 的ImportEntriesForModule 。
- 返回一个新的空
列表 。
16.2.2.3 静态语义：ImportEntriesForModule
- 设 entries1 为
ImportedDefaultBinding 以参数 module 的ImportEntriesForModule 。 - 设 entries2 为
NameSpaceImport 以参数 module 的ImportEntriesForModule 。 - 返回 entries1 和 entries2 的
列表连接 。
- 设 entries1 为
ImportedDefaultBinding 以参数 module 的ImportEntriesForModule 。 - 设 entries2 为
NamedImports 以参数 module 的ImportEntriesForModule 。 - 返回 entries1 和 entries2 的
列表连接 。
- 设 localName 为
ImportedBinding 的BoundNames 的唯一元素。 - 设 defaultEntry 为
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:"default" , [[LocalName]]: localName }。 - 返回 « defaultEntry »。
- 设 localName 为
ImportedBinding 的StringValue 。 - 设 entry 为
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:namespace-object , [[LocalName]]: localName }。 - 返回 « entry »。
- 返回一个新的空
列表 。
- 设 specs1 为
ImportsList 以参数 module 的ImportEntriesForModule 。 - 设 specs2 为
ImportSpecifier 以参数 module 的ImportEntriesForModule 。 - 返回 specs1 和 specs2 的
列表连接 。
- 设 localName 为
ImportedBinding 的BoundNames 的唯一元素。 - 设 entry 为
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: localName, [[LocalName]]: localName }。 - 返回 « entry »。
- 设 importName 为
ModuleExportName 的StringValue 。 - 设 localName 为
ImportedBinding 的StringValue 。 - 设 entry 为
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName }。 - 返回 « entry »。
16.2.2.4 静态语义：WithClauseToAttributes
- 返回一个新的空
列表 。
- 设 attributes 为
WithEntries 的WithClauseToAttributes 。 - 根据 attributes 的 [[Key]] 字段的字典序对其进行排序，将每个这样的字段值视为
UTF-16 代码单元值的序列。注：此排序仅在禁止
宿主 根据属性枚举的顺序改变行为时可观察到。 - 返回 attributes。
- 设 key 为
AttributeKey 的PropName 。 - 设 entry 为
ImportAttribute Record { [[Key]]: key, [[Value]]:StringLiteral 的SV }。 - 返回 « entry »。
- 设 key 为
AttributeKey 的PropName 。 - 设 entry 为
ImportAttribute Record { [[Key]]: key, [[Value]]:StringLiteral 的SV }。 - 设 rest 为
WithEntries 的WithClauseToAttributes 。 - 返回 « entry » 和 rest 的
列表连接 。
16.2.3 导出
语法
16.2.3.1 静态语义：早期错误
-
如果
NamedExports 的ReferencedBindings 包含任何StringLiteral ，这是一个语法错误。 -
对于
NamedExports 的ReferencedBindings 中的每个IdentifierName n：如果 n 的StringValue 是ReservedWord 或 n 的StringValue 是"implements" 、"interface" 、"let" 、"package" 、"private" 、"protected" 、"public" 或"static" 中的一个，这是一个语法错误。
上述规则意味着
16.2.3.2 静态语义：ExportedBindings
ExportedBindings 是与
它在以下产生式上分段定义：
- 设 names1 为
ModuleItemList 的ExportedBindings 。 - 设 names2 为
ModuleItem 的ExportedBindings 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回
NamedExports 的ExportedBindings 。
- 返回
VariableStatement 的BoundNames 。
- 返回
Declaration 的BoundNames 。
- 返回此
ExportDeclaration 的BoundNames 。
- 返回一个新的空
列表 。
- 设 names1 为
ExportsList 的ExportedBindings 。 - 设 names2 为
ExportSpecifier 的ExportedBindings 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个
列表 ，其唯一元素是ModuleExportName 的StringValue 。
- 返回一个
列表 ，其唯一元素是第一个ModuleExportName 的StringValue 。
16.2.3.3 静态语义：ExportedNames
ExportedNames 是
它在以下产生式上分段定义：
- 设 names1 为
ModuleItemList 的ExportedNames 。 - 设 names2 为
ModuleItem 的ExportedNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
列表 。
- 返回一个新的空
列表 。
- 返回一个
列表 ，其唯一元素是ModuleExportName 的StringValue 。
- 返回
NamedExports 的ExportedNames 。
- 返回
VariableStatement 的BoundNames 。
- 返回
Declaration 的BoundNames 。
- 返回 «
"default" »。
- 返回一个新的空
列表 。
- 设 names1 为
ExportsList 的ExportedNames 。 - 设 names2 为
ExportSpecifier 的ExportedNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个
列表 ，其唯一元素是ModuleExportName 的StringValue 。
- 返回一个
列表 ，其唯一元素是第二个ModuleExportName 的StringValue 。
16.2.3.4 静态语义：ExportEntries
- 返回一个新的空
列表 。
- 设 entries1 为
ModuleItemList 的ExportEntries 。 - 设 entries2 为
ModuleItem 的ExportEntries 。 - 返回 entries1 和 entries2 的
列表连接 。
- 返回一个新的空
列表 。
- 设 module 为
ExportDeclaration 的ModuleRequests 的唯一元素。 - 返回
ExportFromClause 以参数 module 的ExportEntriesForModule 。
- 返回
NamedExports 以参数null 的ExportEntriesForModule 。
- 设 entries 为一个新的空
列表 。 - 设 names 为
VariableStatement 的BoundNames 。 - 对于 names 的每个元素 name，执行
- 将
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: name, [[ExportName]]: name } 追加到 entries。
- 将
- 返回 entries。
- 设 entries 为一个新的空
列表 。 - 设 names 为
Declaration 的BoundNames 。 - 对于 names 的每个元素 name，执行
- 将
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: name, [[ExportName]]: name } 追加到 entries。
- 将
- 返回 entries。
- 设 names 为
HoistableDeclaration 的BoundNames 。 - 设 localName 为 names 的唯一元素。
- 返回一个
列表 ，其唯一元素是一个新的ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: localName, [[ExportName]]:"default" }。
- 设 names 为
ClassDeclaration 的BoundNames 。 - 设 localName 为 names 的唯一元素。
- 返回一个
列表 ，其唯一元素是一个新的ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: localName, [[ExportName]]:"default" }。
- 设 entry 为
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]:"*default*" , [[ExportName]]:"default" }。 - 返回 « entry »。
16.2.3.5 静态语义：ExportEntriesForModule
- 设 entry 为
ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:all-but-default , [[LocalName]]:null , [[ExportName]]:null }。 - 返回 « entry »。
- 设 exportName 为
ModuleExportName 的StringValue 。 - 设 entry 为
ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:all , [[LocalName]]:null , [[ExportName]]: exportName }。 - 返回 « entry »。
- 返回一个新的空
列表 。
- 设 specs1 为
ExportsList 以参数 module 的ExportEntriesForModule 。 - 设 specs2 为
ExportSpecifier 以参数 module 的ExportEntriesForModule 。 - 返回 specs1 和 specs2 的
列表连接 。
- 设 sourceName 为
ModuleExportName 的StringValue 。 - 如果 module 是
null ，那么- 设 localName 为 sourceName。
- 设 importName 为
null 。
- 否则，
- 设 localName 为
null 。 - 设 importName 为 sourceName。
- 设 localName 为
- 返回一个
列表 ，其唯一元素是一个新的ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName, [[ExportName]]: sourceName }。
- 设 sourceName 为第一个
ModuleExportName 的StringValue 。 - 设 exportName 为第二个
ModuleExportName 的StringValue 。 - 如果 module 是
null ，那么- 设 localName 为 sourceName。
- 设 importName 为
null 。
- 否则，
- 设 localName 为
null 。 - 设 importName 为 sourceName。
- 设 localName 为
- 返回一个
列表 ，其唯一元素是一个新的ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName, [[ExportName]]: exportName }。
16.2.3.6 静态语义：ReferencedBindings
- 返回一个新的空
列表 。
- 设 names1 为
ExportsList 的ReferencedBindings 。 - 设 names2 为
ExportSpecifier 的ReferencedBindings 。 - 返回 names1 和 names2 的
列表连接 。
- 返回第一个
ModuleExportName 的ReferencedBindings 。
- 返回一个
列表 ，其唯一元素是IdentifierName 。
- 返回一个
列表 ，其唯一元素是StringLiteral 。
16.2.3.7 运行时语义：Evaluation
- 返回
empty 。
- 返回 ?
VariableStatement 的Evaluation 。
- 返回 ?
Declaration 的Evaluation 。
- 返回 ?
HoistableDeclaration 的Evaluation 。
- 设 value 为 ?
ClassDeclaration 的BindingClassDeclarationEvaluation 。 - 设 className 为
ClassDeclaration 的BoundNames 的唯一元素。 - 如果 className 是
"*default*" ，那么- 设 env 为
正在运行的执行上下文 的 LexicalEnvironment。 - 执行 ?
InitializeBoundName ("*default*" , value, env)。
- 设 env 为
- 返回
empty 。
- 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true ，那么- 设 value 为 ?
AssignmentExpression 以参数"default" 的NamedEvaluation 。
- 设 value 为 ?
- 否则，
- 设 rhs 为 ?
AssignmentExpression 的Evaluation 。 - 设 value 为 ?
GetValue (rhs)。
- 设 rhs 为 ?
- 设 env 为
正在运行的执行上下文 的 LexicalEnvironment。 - 执行 ?
InitializeBoundName ("*default*" , value, env)。 - 返回
empty 。
17 错误处理和语言扩展
实现必须在评估相关的 ECMAScript 语言结构时报告大部分错误。早期错误是可以在评估包含错误的 eval 时报告，并阻止 eval
代码的评估。所有不是
实现必须将本规范的"静态语义：早期错误"子条款中列出的任何条件的出现报告为
即使编译器可以证明结构在任何情况下都不能无错误地执行，实现也不应将其他类型的错误视为
实现应按规定报告所有错误，除了以下情况：
-
除了在
17.1 中的限制外，宿主 或实现可以扩展Script 语法、Module 语法以及正则表达式模式或标志语法。为了允许这一点，所有被允许抛出SyntaxError 的操作（如调用eval、使用正则表达式字面量或使用 Function 或 RegExp构造器 ）都被允许表现出宿主定义的 行为，而不是在遇到脚本语法或正则表达式模式或标志语法的宿主定义的 扩展时抛出SyntaxError 。 -
除了在
17.1 中的限制外，宿主 或实现可以提供超出本规范中描述的附加类型、值、对象、属性和函数。这可能导致结构（如在全局作用域中查找变量）具有宿主定义的 行为，而不是抛出错误（如ReferenceError ）。
17.1 禁止的扩展
实现不得以以下方式扩展本规范：
-
在
严格模式代码 中使用语法构造器 定义的 ECMAScript函数对象 不得创建名为"caller" 或"arguments" 的自有属性。对于使用ArrowFunction 、MethodDefinition 、GeneratorDeclaration 、GeneratorExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、ClassDeclaration 、ClassExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 或AsyncArrowFunction 定义的函数对象 ，无论定义是否包含在严格模式代码 中，也不得创建这样的自有属性。内置函数、使用 Function构造器 创建的严格函数 、使用 Generator构造器 创建的生成器函数、使用 AsyncFunction构造器 创建的异步函数以及使用bind方法创建的函数也不得创建这样的自有属性。 -
如果实现用名为
"caller" 的自有属性扩展任何函数对象 ，那么使用 [[Get]] 或 [[GetOwnProperty]] 观察到的该属性的值不得是严格函数 对象。如果它是访问器属性 ，作为属性的 [[Get]] 属性值的函数在被调用时绝不能返回严格函数 。 -
映射或未映射的 arguments 对象都不能创建名为
"caller" 的自有属性。 -
在 ECMA-402 中指定的内置方法的行为（如名为
toLocaleString的方法）不得扩展，除非在 ECMA-402 中指定。 -
22.2.1 和B.1.2 中的 RegExp 模式语法不得扩展为在存在 [UnicodeMode] 语法参数时将任何源字符 A-Z 或 a-z 识别为IdentityEscape 。[+UnicodeMode] -
语法语法不得以任何允许标记
:紧跟由BindingIdentifier 非终结符匹配的源文本的方式进行扩展。 -
当处理
严格模式代码 时，实现不得放宽12.9.3.1 的早期错误 规则。 -
TemplateEscapeSequence 不得扩展为包括在12.9.4 中定义的LegacyOctalEscapeSequence 或NonOctalDecimalEscapeSequence 。 -
当处理
严格模式代码 时，不得支持在B.3.1 、B.3.2 、B.3.3 和B.3.5 中定义的扩展。 -
当为
Module 目标符号 进行解析时，不得支持在B.1.1 中定义的词法语法扩展。 -
ImportCall 不得扩展。
18 ECMAScript 标准内置对象
每当 ECMAScript
除非另有规定，可作为函数调用的内置对象是内置
许多内置对象都是函数：它们可以用参数调用。其中一些还是 new
操作符一起使用的函数。对于每个内置函数，本规范描述了该函数所需的参数和该 new 表达式返回的特定对象实例的属性。
除非在特定函数的描述中另有规定，如果内置函数或
除非在特定函数的描述中另有规定，如果所描述的内置函数或
鼓励向内置函数集添加附加功能的实现通过添加新函数而不是向现有函数添加新参数来实现。
除非另有规定，每个内置函数和每个内置 Function.prototype（
除非另有规定，每个内置原型对象都将 Object.prototype（
如果本规范通过算法步骤定义内置
未被标识为
不是
本规范中定义的每个内置函数都是通过调用
每个内置
例如，
除非另有规定，内置
每个内置
对于
除非另有规定，内置
条款
条款
19 全局对象
全局对象：
- 在控制进入任何
执行上下文 之前创建。 - 没有 [[Construct]] 内部方法；它不能作为
构造器 与new操作符一起使用。 - 没有 [[Call]] 内部方法；它不能作为函数调用。
- 有一个 [[Prototype]] 内部插槽，其值是
宿主定义的 。 - 除了本规范中定义的属性外，还可能有
宿主定义的 属性。这可能包括一个值为全局对象本身的属性。
19.1 全局对象的值属性
19.1.1 globalThis
此属性具有特性 { [[Writable]]:
19.1.2 Infinity
Infinity 的值是
19.1.3 NaN
NaN 的值是
19.1.4 undefined
undefined 的值是
19.2 全局对象的函数属性
19.2.1 eval ( x )
此函数是 %eval% 内置对象。
当被调用时执行以下步骤：
- 返回 ?
PerformEval (x,false ,false )。
19.2.1.1 PerformEval ( x, strictCaller, direct )
抽象操作 PerformEval 接受参数 x（一个
断言 ：如果 direct 是false ，那么 strictCaller 也是false 。- 如果 x
不是字符串 ，返回 x。 - 设 evalRealm 为
当前 Realm Record 。 - 注：在
直接 eval 的情况下，evalRealm 是eval调用者和eval函数本身的境界 。 - 执行 ?
HostEnsureCanCompileStrings (evalRealm, « », x, direct)。 - 设 inFunction 为
false 。 - 设 inMethod 为
false 。 - 设 inDerivedConstructor 为
false 。 - 设 inClassFieldInitializer 为
false 。 - 如果 direct 是
true ，那么- 设 thisEnvRec 为
GetThisEnvironment ()。 - 如果 thisEnvRec 是一个
函数环境记录 ，那么- 设 F 为 thisEnvRec.[[FunctionObject]]。
- 设 inFunction 为
true 。 - 设 inMethod 为 thisEnvRec.HasSuperBinding()。
- 如果 F.[[ConstructorKind]] 是
derived ，设 inDerivedConstructor 为true 。 - 设 classFieldInitializerName 为 F.[[ClassFieldInitializerName]]。
- 如果 classFieldInitializerName 不是
empty ，设 inClassFieldInitializer 为true 。
- 设 thisEnvRec 为
- 以
实现定义的 顺序执行以下子步骤，可能交替进行解析和错误检测：- 设 script 为
ParseText (x,Script )。 - 如果 script 是一个错误的
列表 ，抛出SyntaxError 异常。 - 如果 script
Contains ScriptBody 是false ，返回undefined 。 - 设 body 为 script 的
ScriptBody 。 - 如果 inFunction 是
false 且 bodyContains NewTarget ， 抛出SyntaxError 异常。 - 如果 inMethod 是
false 且 bodyContains SuperProperty ，抛出SyntaxError 异常。 - 如果 inDerivedConstructor 是
false 且 bodyContains SuperCall ， 抛出SyntaxError 异常。 - 如果 inClassFieldInitializer 是
true 且 body 的ContainsArguments 是true ，抛出SyntaxError 异常。
- 设 script 为
- 如果 strictCaller 是
true ，设 strictEval 为true 。 - 否则，设 strictEval 为 script 的
ScriptIsStrict 。 - 设 runningContext 为
正在运行的执行上下文 。 - 注：如果 direct 是
true ，runningContext 将是执行直接 eval 的执行上下文 。如果 direct 是false ，runningContext 将是调用eval函数的执行上下文 。 - 如果 direct 是
true ，那么- 设 lexEnv 为
NewDeclarativeEnvironment (runningContext 的 LexicalEnvironment)。 - 设 varEnv 为 runningContext 的 VariableEnvironment。
- 设 privateEnv 为 runningContext 的 PrivateEnvironment。
- 设 lexEnv 为
- 否则，
- 设 lexEnv 为
NewDeclarativeEnvironment (evalRealm.[[GlobalEnv]])。 - 设 varEnv 为 evalRealm.[[GlobalEnv]]。
- 设 privateEnv 为
null 。
- 设 lexEnv 为
- 如果 strictEval 是
true ，设 varEnv 为 lexEnv。 - 如果 runningContext 尚未挂起，挂起 runningContext。
- 设 evalContext 为一个新的
ECMAScript 代码执行上下文 。 - 设 evalContext 的 Function 为
null 。 - 设 evalContext 的
Realm 为 evalRealm。 - 设 evalContext 的 ScriptOrModule 为 runningContext 的 ScriptOrModule。
- 设 evalContext 的 VariableEnvironment 为 varEnv。
- 设 evalContext 的 LexicalEnvironment 为 lexEnv。
- 设 evalContext 的 PrivateEnvironment 为 privateEnv。
- 将 evalContext 推入
执行上下文栈 ；evalContext 现在是正在运行的执行上下文 。 - 设 result 为
Completion (EvalDeclarationInstantiation (body, varEnv, lexEnv, privateEnv, strictEval))。 - 如果 result 是一个
正常完成 ，那么- 设 result 为
Completion (body 的Evaluation )。
- 设 result 为
- 如果 result 是一个
正常完成 且 result.[[Value]] 是empty ，那么- 设 result 为
NormalCompletion (undefined )。
- 设 result 为
- 挂起 evalContext 并将其从
执行上下文栈 中移除。 - 恢复现在位于
执行上下文栈 顶部的上下文作为正在运行的执行上下文 。 - 返回 ? result。
如果调用上下文的代码或 eval 代码是 let、const 或 class 声明引入的绑定总是在新的
LexicalEnvironment 中实例化。
19.2.1.2 HostEnsureCanCompileStrings ( calleeRealm, parameterStrings, bodyString, direct )
parameterStrings 表示在使用函数 eval 调用的字符串。direct 表示评估是否是
HostEnsureCanCompileStrings 的默认实现是返回
19.2.1.3 EvalDeclarationInstantiation ( body, varEnv, lexEnv, privateEnv, strict )
抽象操作 EvalDeclarationInstantiation 接受参数 body（一个
- 设 varNames 为 body 的
VarDeclaredNames 。 - 设 varDeclarations 为 body 的
VarScopedDeclarations 。 - 如果 strict 是
false ，那么- 如果 varEnv 是一个
全局环境记录 ，那么- 对于 varNames 的每个元素 name，执行
- 如果
HasLexicalDeclaration (varEnv, name) 是true ，抛出SyntaxError 异常。 - 注：
eval不会创建被全局词法声明遮蔽的全局 var 声明。
- 如果
- 对于 varNames 的每个元素 name，执行
- 设 thisEnv 为 lexEnv。
断言 ：以下循环将终止。- 重复，当 thisEnv 和 varEnv 不是同一个
环境记录 时，
- 如果 varEnv 是一个
- 设 privateIdentifiers 为一个新的空
列表 。 - 设 pointer 为 privateEnv。
- 重复，当 pointer 不是
null 时，- 对于 pointer.[[Names]] 的每个
私有名称 binding，执行- 如果 privateIdentifiers 不包含 binding.[[Description]]，将 binding.[[Description]] 添加到 privateIdentifiers。
- 设 pointer 为 pointer.[[OuterPrivateEnvironment]]。
- 对于 pointer.[[Names]] 的每个
- 如果 body 以参数 privateIdentifiers 的
AllPrivateIdentifiersValid 是false ，抛出SyntaxError 异常。 - 设 functionsToInitialize 为一个新的空
列表 。 - 设 declaredFunctionNames 为一个新的空
列表 。 - 对于 varDeclarations 的每个元素 d，以反向
列表 顺序，执行- 如果 d 不是
VariableDeclaration 、ForBinding 或BindingIdentifier ，那么断言 ：d 是FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration 。- 注：如果同一个名称有多个函数声明，使用最后一个声明。
- 设 fn 为 d 的
BoundNames 的唯一元素。 - 如果 declaredFunctionNames 不包含 fn，那么
- 如果 varEnv 是一个
全局环境记录 ，那么- 设 fnDefinable 为 ?
CanDeclareGlobalFunction (varEnv, fn)。 - 如果 fnDefinable 是
false ，抛出TypeError 异常。
- 设 fnDefinable 为 ?
- 将 fn 添加到 declaredFunctionNames。
- 将 d 插入为 functionsToInitialize 的第一个元素。
- 如果 varEnv 是一个
- 如果 d 不是
- 设 declaredVarNames 为一个新的空
列表 。 - 对于 varDeclarations 的每个元素 d，执行
- 如果 d 是
VariableDeclaration 、ForBinding 或BindingIdentifier ，那么- 对于 d 的
BoundNames 的每个字符串 vn，执行- 如果 declaredFunctionNames 不包含 vn，那么
- 如果 varEnv 是一个
全局环境记录 ，那么- 设 vnDefinable 为
?
CanDeclareGlobalVar (varEnv, vn)。 - 如果 vnDefinable 是
false ，抛出TypeError 异常。
- 设 vnDefinable 为
?
- 如果 declaredVarNames 不包含 vn，那么
- 将 vn 添加到 declaredVarNames。
- 如果 varEnv 是一个
- 如果 declaredFunctionNames 不包含 vn，那么
- 对于 d 的
- 如果 d 是
- 注：附录
B.3.2.3 在此处添加额外的步骤。 - 注：除非 varEnv 是一个
全局环境记录 且全局对象 是一个Proxy 异质对象 ，否则在此算法步骤之后不会发生异常终止。 - 设 lexDeclarations 为 body 的
LexicallyScopedDeclarations 。 - 对于 lexDeclarations 的每个元素 d，执行
- 注：词法声明的名称仅在此处实例化但不初始化。
- 对于 d 的
BoundNames 的每个元素 dn，执行- 如果 d 的
IsConstantDeclaration 是true ，那么- 执行
? lexEnv.CreateImmutableBinding(dn,
true )。
- 执行
? lexEnv.CreateImmutableBinding(dn,
- 否则，
- 执行
? lexEnv.CreateMutableBinding(dn,
false )。
- 执行
? lexEnv.CreateMutableBinding(dn,
- 如果 d 的
- 对于 functionsToInitialize 的每个
解析节点 f，执行- 设 fn 为 f 的
BoundNames 的唯一元素。 - 设 fo 为 f 以参数 lexEnv 和 privateEnv
的
InstantiateFunctionObject 。 - 如果 varEnv 是一个
全局环境记录 ，那么- 执行 ?
CreateGlobalFunctionBinding (varEnv, fn, fo,true )。
- 执行 ?
- 否则，
- 设 fn 为 f 的
- 对于 declaredVarNames 的每个字符串 vn，执行
- 如果 varEnv 是一个
全局环境记录 ，那么- 执行 ?
CreateGlobalVarBinding (varEnv, vn,true )。
- 执行 ?
- 否则，
- 如果 varEnv 是一个
- 返回
unused 。
此算法的替代版本在
19.2.2 isFinite ( number )
此函数是 %isFinite% 内置对象。
当被调用时执行以下步骤：
19.2.3 isNaN ( number )
此函数是 %isNaN% 内置对象。
当被调用时执行以下步骤：
- 设 num 为 ?
ToNumber (number)。 - 如果 num 是
NaN ，返回true 。 - 否则，返回
false 。
ECMAScript 代码测试值 X 是否为 X !== X 的表达式。当且仅当 X 是
19.2.4 parseFloat ( string )
此函数根据对 string 参数内容作为十进制字面量的解释产生一个数值。
它是 %parseFloat% 内置对象。
当被调用时执行以下步骤：
- 设 inputString 为 ?
ToString (string)。 - 设 trimmedString 为 !
TrimString (inputString,start )。 - 设 trimmed 为
StringToCodePoints (trimmedString)。 - 设 trimmedPrefix 为满足
StrDecimalLiteral 语法的 trimmed 的最长前缀，可能是 trimmed 本身。如果没有这样的前缀，返回NaN 。 - 设 parsedNumber 为
ParseText (trimmedPrefix,StrDecimalLiteral )。 断言 ： parsedNumber 是一个解析节点 。- 返回 parsedNumber 的
StringNumericValue 。
此函数可能仅将 string 的前导部分解释为数值；它忽略任何不能解释为十进制字面量表示法一部分的代码单元，并且不会给出任何此类代码单元被忽略的指示。
19.2.5 parseInt ( string, radix )
此函数根据指定的 radix 对 string 内容的解释产生一个
它是 %parseInt% 内置对象。
当被调用时执行以下步骤：
- 设 inputString 为 ?
ToString (string)。 - 设 S 为 !
TrimString (inputString,start )。 - 设 sign 为 1。
- 如果 S 不为空且 S 的第一个代码单元是代码单元 0x002D（连字符减号），设 sign 为 -1。
- 如果 S 不为空且 S 的第一个代码单元是代码单元 0x002B（加号）或代码单元 0x002D（连字符减号），设
S 为 S 从索引 1 开始的
子字符串 。 - 设 R 为
ℝ (?ToInt32 (radix))。 - 设 stripPrefix 为
true 。 - 如果 R ≠ 0，那么
- 如果 R < 2 或 R > 36，返回
NaN 。 - 如果 R ≠ 16，设 stripPrefix 为
false 。
- 如果 R < 2 或 R > 36，返回
- 否则，
- 设 R 为 10。
- 如果 stripPrefix 是
true ，那么- 如果 S 的长度至少为 2 且 S 的前两个代码单元是
"0x" 或"0X" ，那么- 设 S 为 S 从索引 2 开始的
子字符串 。 - 设 R 为 16。
- 设 S 为 S 从索引 2 开始的
- 如果 S 的长度至少为 2 且 S 的前两个代码单元是
- 如果 S 包含不是基数-R 数字的代码单元，设 end 为 S 中第一个这样的代码单元的索引；否则，设 end 为 S 的长度。
- 设 Z 为 S 从 0 到 end 的
子字符串 。 - 如果 Z 为空，返回
NaN 。 - 设 mathInt 为以基数-R 表示法表示的 Z 所表示的
整数 值，使用字母 A 到 Z 和 a 到 z 表示值 10 到 35 的数字。（但是，如果 R = 10 且 Z 包含超过 20 个有效数字，实现可以选择将第 20 个之后的每个有效数字替换为 0 数字；如果 R 不是 2、4、8、10、16 或 32 之一，那么 mathInt 可能是一个实现近似的 整数 ，表示 Z 在基数-R 表示法中表示的整数 值。） - 如果 mathInt = 0，那么
- 如果 sign = -1，返回
-0 𝔽。 - 返回
+0 𝔽。
- 如果 sign = -1，返回
- 返回
𝔽 (sign × mathInt)。
19.2.6 URI 处理函数
统一资源标识符（URI）是标识资源（例如网页或文件）和访问它们的传输协议（例如 HTTP 或 FTP）的字符串。ECMAScript 语言本身不提供对使用 URI
的任何支持，除了本节中描述的编码和解码 URI 的函数。encodeURI 和 decodeURI 旨在与完整的 URI
一起工作；它们假设任何保留字符都旨在具有特殊含义（例如，作为分隔符），因此不进行编码。encodeURIComponent 和
decodeURIComponent 旨在与 URI 的各个组件一起工作；它们假设任何保留字符表示文本，必须编码以避免在组件是完整 URI 的一部分时具有特殊含义。
保留字符集基于 RFC 2396，不反映更新的 RFC 3986 引入的更改。
许多 ECMAScript 实现提供操作网页的附加函数和方法；这些函数超出了本标准的范围。
19.2.6.1 decodeURI ( encodedURI )
此函数计算 URI 的新版本，其中每个可能由 encodeURI 函数引入的转义序列和 UTF-8 编码都被其表示的代码点的 UTF-16 编码替换。不可能由
encodeURI 引入的转义序列不被替换。
它是 %decodeURI% 内置对象。
当被调用时执行以下步骤：
19.2.6.2 decodeURIComponent ( encodedURIComponent )
此函数计算 URI 的新版本，其中每个可能由 encodeURIComponent 函数引入的转义序列和 UTF-8 编码都被其表示的代码点的 UTF-16
编码替换。
它是 %decodeURIComponent% 内置对象。
当被调用时执行以下步骤：
19.2.6.3 encodeURI ( uri )
此函数计算 UTF-16 编码（
它是 %encodeURI% 内置对象。
当被调用时执行以下步骤：
19.2.6.4 encodeURIComponent ( uriComponent )
此函数计算 UTF-16 编码（
它是 %encodeURIComponent% 内置对象。
当被调用时执行以下步骤：
19.2.6.5 Encode ( string, extraUnescaped )
抽象操作 Encode 接受参数 string（一个字符串）和 extraUnescaped（一个字符串），返回一个包含字符串的
- 设 len 为 string 的长度。
- 设 R 为空字符串。
- 设 alwaysUnescaped 为
ASCII 单词字符 和"-.!~*'()" 的字符串连接 。 - 设 unescapedSet 为 alwaysUnescaped 和 extraUnescaped 的
字符串连接 。 - 设 k 为 0。
- 重复，当 k < len 时，
- 设 C 为 string 中索引 k 处的代码单元。
- 如果 unescapedSet 包含 C，那么
- 设 k 为 k + 1。
- 设 R 为 R 和 C 的
字符串连接 。
- 否则，
- 设 cp 为
CodePointAt (string, k)。 - 如果 cp.[[IsUnpairedSurrogate]] 是
true ，抛出URIError 异常。 - 设 k 为 k + cp.[[CodeUnitCount]]。
- 设 Octets 为通过对 cp.[[CodePoint]] 应用 UTF-8 变换得到的八位字节的
列表 。 - 对于 Octets 的每个元素 octet，执行
- 设 cp 为
- 返回 R。
因为百分号编码用于表示单个八位字节，所以单个代码点可能表示为多个连续的转义序列（其 8 位 UTF-8 代码单元的每一个对应一个）。
19.2.6.6 Decode ( string, preserveEscapeSet )
抽象操作 Decode 接受参数 string（一个字符串）和 preserveEscapeSet（一个字符串），返回一个包含字符串的
- 设 len 为 string 的长度。
- 设 R 为空字符串。
- 设 k 为 0。
- 重复，当 k < len 时，
- 设 C 为 string 中索引 k 处的代码单元。
- 设 S 为 C。
- 如果 C 是代码单元 0x0025（百分号），那么
- 如果 k + 3 > len，抛出
URIError 异常。 - 设 escape 为 string 从 k 到
k + 3 的
子字符串 。 - 设 B 为
ParseHexOctet (string, k + 1)。 - 如果 B 不是一个
整数 ，抛出URIError 异常。 - 设 k 为 k + 2。
- 设 n 为 B 中前导 1 位的数量。
- 如果 n = 0，那么
- 设 asciiChar 为数值为 B 的代码单元。
- 如果 preserveEscapeSet 包含 asciiChar，设 S 为 escape。否则，设 S 为 asciiChar。
- 否则，
- 如果 n = 1 或 n > 4，抛出
URIError 异常。 - 设 Octets 为 « B »。
- 设 j 为 1。
- 重复，当 j < n 时，
- 设 k 为 k + 1。
- 如果 k + 3 > len，抛出
URIError 异常。 - 如果 string 中索引 k 处的代码单元不是代码单元
0x0025（百分号），抛出
URIError 异常。 - 设 continuationByte 为
ParseHexOctet (string, k + 1)。 - 如果 continuationByte 不是一个
整数 ，抛出URIError 异常。 - 将 continuationByte 添加到 Octets。
- 设 k 为 k + 2。
- 设 j 为 j + 1。
断言 ：Octets 的长度是 n。- 如果 Octets 不包含 Unicode 代码点的有效 UTF-8 编码，抛出
URIError 异常。 - 设 V 为通过对 Octets 应用 UTF-8
变换获得的代码点，即从八位字节的
列表 到 21 位值。 - 设 S 为
UTF16EncodeCodePoint (V)。
- 如果 n = 1 或 n > 4，抛出
- 如果 k + 3 > len，抛出
- 设 R 为 R 和 S 的
字符串连接 。 - 设 k 为 k + 1。
- 返回 R。
RFC 3629 禁止解码无效的 UTF-8 八位字节序列。例如，无效序列 0xC0 0x80 不得解码为代码单元 0x0000。Decode
算法的实现在遇到此类无效序列时必须抛出
19.2.6.7 ParseHexOctet ( string, position )
抽象操作 ParseHexOctet 接受参数 string（一个字符串）和 position（一个非负
19.3 全局对象的构造器属性
19.3.1 AggregateError ( . . . )
参见
19.3.2 Array ( . . . )
参见
19.3.3 ArrayBuffer ( . . . )
参见
19.3.4 BigInt ( . . . )
参见
19.3.5 BigInt64Array ( . . . )
参见
19.3.6 BigUint64Array ( . . . )
参见
19.3.7 Boolean ( . . . )
参见
19.3.8 DataView ( . . . )
参见
19.3.9 Date ( . . . )
参见
19.3.10 Error ( . . . )
参见
19.3.11 EvalError ( . . . )
参见
19.3.12 FinalizationRegistry ( . . . )
参见
19.3.13 Float16Array ( . . . )
参见
19.3.14 Float32Array ( . . . )
参见
19.3.15 Float64Array ( . . . )
参见
19.3.16 Function ( . . . )
参见
19.3.17 Int8Array ( . . . )
参见
19.3.18 Int16Array ( . . . )
参见
19.3.19 Int32Array ( . . . )
参见
19.3.20 Iterator ( . . . )
参见
19.3.21 Map ( . . . )
参见
19.3.22 Number ( . . . )
参见
19.3.23 Object ( . . . )
参见
19.3.24 Promise ( . . . )
参见
19.3.25 Proxy ( . . . )
参见
19.3.26 RangeError ( . . . )
参见
19.3.27 ReferenceError ( . . . )
参见
19.3.28 RegExp ( . . . )
参见
19.3.29 Set ( . . . )
参见
19.3.30 SharedArrayBuffer ( . . . )
参见
19.3.31 String ( . . . )
参见
19.3.32 Symbol ( . . . )
参见
19.3.33 SyntaxError ( . . . )
参见
19.3.34 TypeError ( . . . )
参见
19.3.35 Uint8Array ( . . . )
参见
19.3.36 Uint8ClampedArray ( . . . )
参见
19.3.37 Uint16Array ( . . . )
参见
19.3.38 Uint32Array ( . . . )
参见
19.3.39 URIError ( . . . )
参见
19.3.40 WeakMap ( . . . )
参见
19.3.41 WeakRef ( . . . )
参见
19.3.42 WeakSet ( . . . )
参见
19.4 全局对象的其他属性
19.4.1 Atomics
参见
19.4.2 JSON
参见
19.4.3 Math
参见
19.4.4 Reflect
参见
20 基础对象
20.1 Object 对象
20.1.1 Object 构造器
Object
- 是 %Object%。
- 是
全局对象 的"Object" 属性的初始值。 - 当作为
构造器 调用时，创建一个新的普通对象 。 - 当作为函数而不是
构造器 调用时，执行类型转换。 - 可以用作类定义的
extends子句的值。
20.1.1.1 Object ( [ value ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 既不是
undefined 也不是活动函数对象 ，那么- 返回 ?
OrdinaryCreateFromConstructor (NewTarget,"%Object.prototype%" )。
- 返回 ?
- 如果 value 是
undefined 或null ，返回OrdinaryObjectCreate (%Object.prototype% )。 - 返回 !
ToObject (value)。
20.1.2 Object 构造器的属性
Object
- 有一个 [[Prototype]] 内部槽，其值是
%Function.prototype% 。 - 有一个
"length" 属性，其值是1 𝔽。 - 有以下附加属性：
20.1.2.1 Object.assign ( target, ...sources )
此函数从一个或多个源对象复制所有可枚举自有属性的值到 target 对象。
当被调用时执行以下步骤：
- 设 to 为 ?
ToObject (target)。 - 如果只传递了一个参数，返回 to。
- 对于 sources 的每个元素 nextSource，执行
- 如果 nextSource 既不是
undefined 也不是null ，那么
- 如果 nextSource 既不是
- 返回 to。
此函数的
20.1.2.2 Object.create ( O, Properties )
此函数创建一个具有指定原型的新对象。
当被调用时执行以下步骤：
- 如果 O
不是一个对象 且 O 不是null ，抛出TypeError 异常。 - 设 obj 为
OrdinaryObjectCreate (O)。 - 如果 Properties 不是
undefined ，那么- 返回 ?
ObjectDefineProperties (obj, Properties)。
- 返回 ?
- 返回 obj。
20.1.2.3 Object.defineProperties ( O, Properties )
此函数添加自有属性和/或更新对象现有自有属性的特性。
当被调用时执行以下步骤：
- 如果 O
不是一个对象 ，抛出TypeError 异常。 - 返回 ?
ObjectDefineProperties (O, Properties)。
20.1.2.3.1 ObjectDefineProperties ( O, Properties )
抽象操作 ObjectDefineProperties 接受参数 O（一个对象）和 Properties（一个
- 设 props 为 ?
ToObject (Properties)。 - 设 keys 为 ? props.[[OwnPropertyKeys]]()。
- 设 descriptors 为一个新的空
列表 。 - 对于 keys 的每个元素 nextKey，执行
- 设 propDesc 为 ? props.[[GetOwnProperty]](nextKey)。
- 如果 propDesc 不是
undefined 且 propDesc.[[Enumerable]] 是true ，那么- 设 descObj 为 ?
Get (props, nextKey)。 - 设 desc 为 ?
ToPropertyDescriptor (descObj)。 - 将
记录 { [[Key]]: nextKey, [[Descriptor]]: desc } 追加到 descriptors。
- 设 descObj 为 ?
- 对于 descriptors 的每个元素 property，执行
- 执行 ?
DefinePropertyOrThrow (O, property.[[Key]], property.[[Descriptor]])。
- 执行 ?
- 返回 O。
20.1.2.4 Object.defineProperty ( O, P, Attributes )
此函数添加一个自有属性和/或更新对象现有自有属性的特性。
当被调用时执行以下步骤：
- 如果 O
不是一个对象 ，抛出TypeError 异常。 - 设 key 为 ?
ToPropertyKey (P)。 - 设 desc 为 ?
ToPropertyDescriptor (Attributes)。 - 执行 ?
DefinePropertyOrThrow (O, key, desc)。 - 返回 O。
20.1.2.5 Object.entries ( O )
此函数在被调用时执行以下步骤：
- 设 obj 为 ?
ToObject (O)。 - 设 entryList 为 ?
EnumerableOwnProperties (obj,key+value )。 - 返回
CreateArrayFromList (entryList)。
20.1.2.6 Object.freeze ( O )
此函数在被调用时执行以下步骤：
- 如果 O
不是一个对象 ，返回 O。 - 设 status 为 ?
SetIntegrityLevel (O,frozen )。 - 如果 status 是
false ，抛出TypeError 异常。 - 返回 O。
20.1.2.7 Object.fromEntries ( iterable )
此函数在被调用时执行以下步骤：
- 执行 ?
RequireObjectCoercible (iterable)。 - 设 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 断言 ： obj 是一个可扩展的普通对象 ，没有自有属性。- 设 closure 为一个新的
抽象闭包 ，参数为 (key, value)，捕获 obj，当被调用时执行以下步骤：- 设 propertyKey 为 ?
ToPropertyKey (key)。 - 执行 !
CreateDataPropertyOrThrow (obj, propertyKey, value)。 - 返回
undefined 。
- 设 propertyKey 为 ?
- 设 adder 为
CreateBuiltinFunction (closure, 2,"" , « »)。 - 返回 ?
AddEntriesFromIterable (obj, iterable, adder)。
20.1.2.8 Object.getOwnPropertyDescriptor ( O, P )
此函数在被调用时执行以下步骤：
- 设 obj 为 ?
ToObject (O)。 - 设 key 为 ?
ToPropertyKey (P)。 - 设 desc 为 ? obj.[[GetOwnProperty]](key)。
- 返回
FromPropertyDescriptor (desc)。
20.1.2.9 Object.getOwnPropertyDescriptors ( O )
此函数在被调用时执行以下步骤：
- 设 obj 为 ?
ToObject (O)。 - 设 ownKeys 为 ? obj.[[OwnPropertyKeys]]()。
- 设 descriptors 为
OrdinaryObjectCreate (%Object.prototype% )。 - 对于 ownKeys 的每个元素 key，执行
- 设 desc 为 ? obj.[[GetOwnProperty]](key)。
- 设 descriptor 为
FromPropertyDescriptor (desc)。 - 如果 descriptor 不是
undefined ，执行 !CreateDataPropertyOrThrow (descriptors, key, descriptor)。
- 返回 descriptors。
20.1.2.10 Object.getOwnPropertyNames ( O )
此函数在被调用时执行以下步骤：
- 返回
CreateArrayFromList (?GetOwnPropertyKeys (O,string ))。
20.1.2.11 Object.getOwnPropertySymbols ( O )
此函数在被调用时执行以下步骤：
- 返回
CreateArrayFromList (?GetOwnPropertyKeys (O,symbol ))。
20.1.2.11.1 GetOwnPropertyKeys ( O, type )
抽象操作 GetOwnPropertyKeys 接受参数 O（一个
20.1.2.12 Object.getPrototypeOf ( O )
此函数在被调用时执行以下步骤：
- 设 obj 为 ?
ToObject (O)。 - 返回 ? obj.[[GetPrototypeOf]]()。
20.1.2.13 Object.groupBy ( items, callback )
callback 应该是一个接受两个参数的函数。groupBy 按升序为 items
中的每个元素调用一次 callback，并构造一个新对象。callback 返回的每个值都被强制转换为
callback 用两个参数调用：元素的值和元素的索引。
groupBy 的返回值是一个不继承自
此函数在被调用时执行以下步骤：
- 设 groups 为 ?
GroupBy (items, callback,property )。 - 设 obj 为
OrdinaryObjectCreate (null )。 - 对于 groups 的每个
记录 { [[Key]], [[Elements]] } g，执行- 设 elements 为
CreateArrayFromList (g.[[Elements]])。 - 执行 !
CreateDataPropertyOrThrow (obj, g.[[Key]], elements)。
- 设 elements 为
- 返回 obj。
20.1.2.14 Object.hasOwn ( O, P )
此函数在被调用时执行以下步骤：
- 设 obj 为 ?
ToObject (O)。 - 设 key 为 ?
ToPropertyKey (P)。 - 返回 ?
HasOwnProperty (obj, key)。
20.1.2.15 Object.is ( value1, value2 )
此函数在被调用时执行以下步骤：
- 返回
SameValue (value1, value2)。
20.1.2.16 Object.isExtensible ( O )
此函数在被调用时执行以下步骤：
- 如果 O
不是一个对象 ，返回false 。 - 返回 ?
IsExtensible (O)。
20.1.2.17 Object.isFrozen ( O )
此函数在被调用时执行以下步骤：
- 如果 O
不是一个对象 ，返回true 。 - 返回 ?
TestIntegrityLevel (O,frozen )。
20.1.2.18 Object.isSealed ( O )
此函数在被调用时执行以下步骤：
- 如果 O
不是一个对象 ，返回true 。 - 返回 ?
TestIntegrityLevel (O,sealed )。
20.1.2.19 Object.keys ( O )
此函数在被调用时执行以下步骤：
- 设 obj 为 ?
ToObject (O)。 - 设 keyList 为 ?
EnumerableOwnProperties (obj,key )。 - 返回
CreateArrayFromList (keyList)。
20.1.2.20 Object.preventExtensions ( O )
此函数在被调用时执行以下步骤：
- 如果 O
不是一个对象 ，返回 O。 - 设 status 为 ? O.[[PreventExtensions]]()。
- 如果 status 是
false ，抛出TypeError 异常。 - 返回 O。
20.1.2.21 Object.prototype
Object.prototype 的初始值是
此属性有特性 { [[Writable]]:
20.1.2.22 Object.seal ( O )
此函数在被调用时执行以下步骤：
- 如果 O
不是一个对象 ，返回 O。 - 设 status 为 ?
SetIntegrityLevel (O,sealed )。 - 如果 status 是
false ，抛出TypeError 异常。 - 返回 O。
20.1.2.23 Object.setPrototypeOf ( O, proto )
此函数在被调用时执行以下步骤：
- 设 O 为 ?
RequireObjectCoercible (O)。 - 如果 proto
不是一个对象 且 proto 不是null ，抛出TypeError 异常。 - 如果 O
不是一个对象 ，返回 O。 - 设 status 为 ? O.[[SetPrototypeOf]](proto)。
- 如果 status 是
false ，抛出TypeError 异常。 - 返回 O。
20.1.2.24 Object.values ( O )
此函数在被调用时执行以下步骤：
- 设 obj 为 ?
ToObject (O)。 - 设 valueList 为 ?
EnumerableOwnProperties (obj,value )。 - 返回
CreateArrayFromList (valueList)。
20.1.3 Object 原型对象的属性
Object 原型对象：
- 是 %Object.prototype%。
- 有一个 [[Extensible]] 内部槽，其值是
true 。 - 有为
普通对象 定义的内部方法，除了 [[SetPrototypeOf]] 方法，它按照10.4.7.1 中的定义。 （因此，它是一个不可变原型外来对象 。） - 有一个 [[Prototype]] 内部槽，其值是
null 。
20.1.3.1 Object.prototype.constructor
Object.prototype.constructor 的初始值是
20.1.3.2 Object.prototype.hasOwnProperty ( V )
此方法在被调用时执行以下步骤：
- 设 P 为 ?
ToPropertyKey (V)。 - 设 O 为 ?
ToObject (this 值)。 - 返回 ?
HasOwnProperty (O, P)。
20.1.3.3 Object.prototype.isPrototypeOf ( V )
此方法在被调用时执行以下步骤：
20.1.3.4 Object.prototype.propertyIsEnumerable ( V )
此方法在被调用时执行以下步骤：
- 设 P 为 ?
ToPropertyKey (V)。 - 设 O 为 ?
ToObject (this 值)。 - 设 desc 为 ? O.[[GetOwnProperty]](P)。
- 如果 desc 是
undefined ，返回false 。 - 返回 desc.[[Enumerable]]。
此方法不考虑原型链中的对象。
20.1.3.5 Object.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
此方法在被调用时执行以下步骤：
- 设 O 为
this 值。 - 返回 ?
Invoke (O,"toString" )。
此方法的可选参数未被使用，但旨在对应 ECMA-402 toLocaleString 方法使用的参数模式。不包含 ECMA-402
支持的实现不得将这些参数位置用于其他目的。
此方法为没有区域敏感的 toString 行为的对象提供通用的 toLocaleString
实现。Array、Number、Date 和 toLocaleString 方法。
ECMA-402 故意不为此默认实现提供替代方案。
20.1.3.6 Object.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 如果
this 值是undefined ，返回"[object Undefined]" 。 - 如果
this 值是null ，返回"[object Null]" 。 - 设 O 为 !
ToObject (this 值)。 - 设 isArray 为 ?
IsArray (O)。 - 如果 isArray 是
true ，设 builtinTag 为"Array" 。 - 否则如果 O 有一个 [[ParameterMap]] 内部槽，设
builtinTag 为
"Arguments" 。 - 否则如果 O 有一个 [[Call]] 内部方法，设 builtinTag
为
"Function" 。 - 否则如果 O 有一个 [[ErrorData]] 内部槽，设
builtinTag 为
"Error" 。 - 否则如果 O 有一个 [[BooleanData]] 内部槽，设
builtinTag 为
"Boolean" 。 - 否则如果 O 有一个 [[NumberData]] 内部槽，设
builtinTag 为
"Number" 。 - 否则如果 O 有一个 [[StringData]] 内部槽，设
builtinTag 为
"String" 。 - 否则如果 O 有一个 [[DateValue]] 内部槽，设
builtinTag 为
"Date" 。 - 否则如果 O 有一个 [[RegExpMatcher]] 内部槽，设
builtinTag 为
"RegExp" 。 - 否则，设 builtinTag 为
"Object" 。 - 设 tag 为 ?
Get (O,%Symbol.toStringTag% )。 - 如果 tag
不是一个字符串 ，设 tag 为 builtinTag。 - 返回
"[object " 、tag 和"]" 的字符串连接 。
历史上，此方法偶尔被用来访问 [[Class]]
内部槽的字符串值，该内部槽在此规范的以前版本中用作各种内建对象的名义类型标签。上述 toString 的定义为使用
toString
作为那些特定类型的内建对象测试的遗留代码保持兼容性。它不为其他类型的内建或程序定义的对象提供可靠的类型测试机制。此外，程序可以以会使此类遗留类型测试的可靠性失效的方式使用
20.1.3.7 Object.prototype.valueOf ( )
此方法在被调用时执行以下步骤：
- 返回 ?
ToObject (this 值)。
20.1.3.8 Object.prototype.__proto__
Object.prototype.__proto__ 是一个
20.1.3.8.1 get Object.prototype.__proto__
[[Get]] 特性的值是一个不需要参数的内建函数。当被调用时执行以下步骤：
- 设 O 为 ?
ToObject (this 值)。 - 返回 ? O.[[GetPrototypeOf]]()。
20.1.3.8.2 set Object.prototype.__proto__
[[Set]] 特性的值是一个接受参数 proto 的内建函数。当被调用时执行以下步骤：
- 设 O 为 ?
RequireObjectCoercible (this 值)。 - 如果 proto
不是一个对象 且 proto 不是null ，返回undefined 。 - 如果 O
不是一个对象 ，返回undefined 。 - 设 status 为 ? O.[[SetPrototypeOf]](proto)。
- 如果 status 是
false ，抛出TypeError 异常。 - 返回
undefined 。
20.1.3.9 遗留的 Object.prototype 访问器方法
20.1.3.9.1 Object.prototype.__defineGetter__ ( P, getter )
此方法在被调用时执行以下步骤：
- 设 O 为 ?
ToObject (this 值)。 - 如果
IsCallable (getter) 是false ，抛出TypeError 异常。 - 设 desc 为 PropertyDescriptor { [[Get]]:
getter，[[Enumerable]]:
true ，[[Configurable]]:true }。 - 设 key 为 ?
ToPropertyKey (P)。 - 执行 ?
DefinePropertyOrThrow (O, key, desc)。 - 返回
undefined 。
20.1.3.9.2 Object.prototype.__defineSetter__ ( P, setter )
此方法在被调用时执行以下步骤：
- 设 O 为 ?
ToObject (this 值)。 - 如果
IsCallable (setter) 是false ，抛出TypeError 异常。 - 设 desc 为 PropertyDescriptor { [[Set]]:
setter，[[Enumerable]]:
true ，[[Configurable]]:true }。 - 设 key 为 ?
ToPropertyKey (P)。 - 执行 ?
DefinePropertyOrThrow (O, key, desc)。 - 返回
undefined 。
20.1.3.9.3 Object.prototype.__lookupGetter__ ( P )
此方法在被调用时执行以下步骤：
- 设 O 为 ?
ToObject (this 值)。 - 设 key 为 ?
ToPropertyKey (P)。 - 重复，
- 设 desc 为 ? O.[[GetOwnProperty]](key)。
- 如果 desc 不是
undefined ，那么- 如果
IsAccessorDescriptor (desc) 是true ，返回 desc.[[Get]]。 - 返回
undefined 。
- 如果
- 设 O 为 ? O.[[GetPrototypeOf]]()。
- 如果 O 是
null ，返回undefined 。
20.1.3.9.4 Object.prototype.__lookupSetter__ ( P )
此方法在被调用时执行以下步骤：
- 设 O 为 ?
ToObject (this 值)。 - 设 key 为 ?
ToPropertyKey (P)。 - 重复，
- 设 desc 为 ? O.[[GetOwnProperty]](key)。
- 如果 desc 不是
undefined ，那么- 如果
IsAccessorDescriptor (desc) 是true ，返回 desc.[[Set]]。 - 返回
undefined 。
- 如果
- 设 O 为 ? O.[[GetPrototypeOf]]()。
- 如果 O 是
null ，返回undefined 。
20.1.4 Object 实例的属性
Object 实例除了从
20.2 Function 对象
20.2.1 Function 构造器
Function
- 是 %Function%。
- 是
全局对象 的"Function" 属性的初始值。 - 当作为函数而不是作为
构造器 调用时，创建并初始化一个新的函数对象 。因此函数调用Function(…)等价于使用相同参数的对象创建表达式new Function(…)。 - 可以用作类定义中
extends子句的值。打算继承指定的 Function 行为的子类构造器 必须包含一个对 Function构造器 的super调用，以创建和初始化具有内建函数行为所需的内部槽的子类实例。所有用于定义函数对象 的 ECMAScript 语法形式都创建 Function 的实例。除了内建的 GeneratorFunction、AsyncFunction 和 AsyncGeneratorFunction 子类之外，没有语法方式来创建 Function 子类的实例。
20.2.1.1 Function ( ...parameterArgs, bodyArg )
最后一个参数（如果有的话）指定函数的主体（可执行代码）；任何前面的参数指定形式参数。
此函数在被调用时执行以下步骤：
- 设 C 为
活动函数对象 。 - 如果 bodyArg 不存在，设 bodyArg 为空字符串。
- 返回 ?
CreateDynamicFunction (C, NewTarget,normal , parameterArgs, bodyArg)。
为要指定的每个形式参数都有一个参数是允许的但不是必需的。例如，以下三个表达式都产生相同的结果：
new Function("a", "b", "c", "return a+b+c")
new Function("a, b, c", "return a+b+c")
new Function("a,b", "c", "return a+b+c")20.2.1.1.1 CreateDynamicFunction ( constructor, newTarget, kind, parameterArgs, bodyArg )
抽象操作 CreateDynamicFunction 接受参数 constructor（一个 new 的
- 如果 newTarget 是
undefined ，设 newTarget 为 constructor。 - 如果 kind 是
normal ，那么- 设 prefix 为
"function" 。 - 设 exprSym 为语法符号
FunctionExpression 。 - 设 bodySym 为语法符号
FunctionBody 。[~Yield, ~Await] - 设 parameterSym 为语法符号
FormalParameters 。[~Yield, ~Await] - 设 fallbackProto 为
"%Function.prototype%" 。
- 设 prefix 为
- 否则如果 kind 是
generator ，那么- 设 prefix 为
"function*" 。 - 设 exprSym 为语法符号
GeneratorExpression 。 - 设 bodySym 为语法符号
GeneratorBody 。 - 设 parameterSym 为语法符号
FormalParameters 。[+Yield, ~Await] - 设 fallbackProto 为
"%GeneratorFunction.prototype%" 。
- 设 prefix 为
- 否则如果 kind 是
async ，那么- 设 prefix 为
"async function" 。 - 设 exprSym 为语法符号
AsyncFunctionExpression 。 - 设 bodySym 为语法符号
AsyncFunctionBody 。 - 设 parameterSym 为语法符号
FormalParameters 。[~Yield, +Await] - 设 fallbackProto 为
"%AsyncFunction.prototype%" 。
- 设 prefix 为
- 否则，
断言 ：kind 是async-generator 。- 设 prefix 为
"async function*" 。 - 设 exprSym 为语法符号
AsyncGeneratorExpression 。 - 设 bodySym 为语法符号
AsyncGeneratorBody 。 - 设 parameterSym 为语法符号
FormalParameters 。[+Yield, +Await] - 设 fallbackProto 为
"%AsyncGeneratorFunction.prototype%" 。
- 设 argCount 为 parameterArgs 中元素的数量。
- 设 parameterStrings 为一个新的空
列表 。 - 对于 parameterArgs 的每个元素 arg，执行
- 将 ?
ToString (arg) 追加到 parameterStrings。
- 将 ?
- 设 bodyString 为 ?
ToString (bodyArg)。 - 设 currentRealm 为
当前 Realm 记录 。 - 执行 ?
HostEnsureCanCompileStrings (currentRealm, parameterStrings, bodyString,false )。 - 设 P 为空字符串。
- 如果 argCount > 0，那么
- 设 P 为 parameterStrings[0]。
- 设 k 为 1。
- 重复，当 k < argCount 时，
- 设 nextArgString 为 parameterStrings[k]。
- 设 P 为 P、
"," （逗号）和 nextArgString 的字符串连接 。 - 设 k 为 k + 1。
- 设 bodyParseString 为 0x000A（换行符）、bodyString 和 0x000A（换行符）的
字符串连接 。 - 设 sourceString 为 prefix、
" anonymous(" 、P、0x000A（换行符）、") {" 、bodyParseString 和"}" 的字符串连接 。 - 设 sourceText 为
StringToCodePoints (sourceString)。 - 设 parameters 为
ParseText (P, parameterSym)。 - 如果 parameters 是一个错误的
列表 ，抛出SyntaxError 异常。 - 设 body 为
ParseText (bodyParseString, bodySym)。 - 如果 body 是一个错误的
列表 ，抛出SyntaxError 异常。 - 注：参数和主体分别解析以确保各自都是有效的。例如，
new Function("/*", "*/ ) {")不会计算为函数。 - 注：如果达到这一步，sourceText 必须具有 exprSym 的语法（尽管反向含义不成立）。接下来两步的目的是执行直接应用于 exprSym 的任何早期错误规则。
- 设 expr 为
ParseText (sourceText, exprSym)。 - 如果 expr 是一个错误的
列表 ，抛出SyntaxError 异常。 - 设 proto 为 ?
GetPrototypeFromConstructor (newTarget, fallbackProto)。 - 设 env 为 currentRealm.[[GlobalEnv]]。
- 设 privateEnv 为
null 。 - 设 F 为
OrdinaryFunctionCreate (proto, sourceText, parameters, body,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F,"anonymous" )。 - 如果 kind 是
generator ，那么- 设 prototype 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。
- 设 prototype 为
- 否则如果 kind 是
async-generator ，那么- 设 prototype 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。
- 设 prototype 为
- 否则如果 kind 是
normal ，那么- 执行
MakeConstructor (F)。
- 执行
- 注：kind 为
async 的函数不可构造且没有 [[Construct]] 内部方法或"prototype" 属性。 - 返回 F。
CreateDynamicFunction 在它创建的任何 kind 不是
20.2.2 Function 构造器的属性
Function
- 本身是一个内建的
函数对象 。 - 有一个 [[Prototype]] 内部槽，其值是
%Function.prototype% 。 - 有一个
"length" 属性，其值是1 𝔽。 - 有以下属性：
20.2.2.1 Function.prototype
Function.prototype 的值是
此属性有特性 { [[Writable]]:
20.2.3 Function 原型对象的属性
Function 原型对象：
- 是 %Function.prototype%。
- 本身是一个内建的
函数对象 。 - 接受任何参数并在调用时返回
undefined 。 - 没有 [[Construct]] 内部方法；它不能与
new操作符一起用作构造器 。 - 有一个 [[Prototype]] 内部槽，其值是
%Object.prototype% 。 - 没有
"prototype" 属性。 - 有一个
"length" 属性，其值是+0 𝔽。 - 有一个
"name" 属性，其值是空字符串。
Function 原型对象被指定为
20.2.3.1 Function.prototype.apply ( thisArg, argArray )
此方法在被调用时执行以下步骤：
- 设 func 为
this 值。 - 如果
IsCallable (func) 是false ，抛出TypeError 异常。 - 如果 argArray 是
undefined 或null ，那么- 执行
PrepareForTailCall ()。 - 返回 ?
Call (func, thisArg)。
- 执行
- 设 argList 为 ?
CreateListFromArrayLike (argArray)。 - 执行
PrepareForTailCall ()。 - 返回 ?
Call (func, thisArg, argList)。
20.2.3.2 Function.prototype.bind ( thisArg, ...args )
此方法在被调用时执行以下步骤：
- 设 Target 为
this 值。 - 如果
IsCallable (Target) 是false ，抛出TypeError 异常。 - 设 F 为 ?
BoundFunctionCreate (Target, thisArg, args)。 - 设 L 为 0。
- 设 targetHasLength 为 ?
HasOwnProperty (Target,"length" )。 - 如果 targetHasLength 是
true ，那么 - 执行
SetFunctionLength (F, L)。 - 设 targetName 为 ?
Get (Target,"name" )。 - 如果 targetName
不是字符串 ，设 targetName 为空字符串。 - 执行
SetFunctionName (F, targetName,"bound" )。 - 返回 F。
如果 Target 是箭头函数或
20.2.3.3 Function.prototype.call ( thisArg, ...args )
此方法在被调用时执行以下步骤：
- 设 func 为
this 值。 - 如果
IsCallable (func) 是false ，抛出TypeError 异常。 - 执行
PrepareForTailCall ()。 - 返回 ?
Call (func, thisArg, args)。
20.2.3.4 Function.prototype.constructor
Function.prototype.constructor 的初始值是
20.2.3.5 Function.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 设 func 为
this 值。 - 如果 func
是一个对象 ，func 有一个 [[SourceText]] 内部槽，func.[[SourceText]] 是一个 Unicode 码点序列，并且HostHasSourceTextAvailable (func) 是true ，那么- 返回
CodePointsToString (func.[[SourceText]])。
- 返回
- 如果 func 是一个
内建函数对象 ，返回 func 的实现定义的 字符串源代码表示。该表示必须具有NativeFunction 的语法。另外，如果 func 有一个 [[InitialName]] 内部槽且 func.[[InitialName]]是一个字符串 ，返回的字符串中与NativeFunctionAccessor opt PropertyName 匹配的部分必须是 func.[[InitialName]] 的值。 - 如果 func
是一个对象 且IsCallable (func) 是true ，返回 func 的实现定义的 字符串源代码表示。该表示必须具有NativeFunction 的语法。 - 抛出
TypeError 异常。
20.2.3.6 Function.prototype [ %Symbol.hasInstance% ] ( V )
此方法在被调用时执行以下步骤：
- 设 F 为
this 值。 - 返回 ?
OrdinaryHasInstance (F, V)。
此属性有特性 { [[Writable]]:
此属性是不可写和不可配置的，以防止可能用于全局暴露绑定函数目标函数的篡改。
此方法的
20.2.4 Function 实例
每个 Function 实例都是一个 ECMAScript Function.prototype.bind 方法（
Function 实例有以下属性：
20.2.4.1 length
20.2.4.2 name
本规范没有关联上下文名称的匿名函数对象使用空字符串作为
20.2.4.3 prototype
可以用作
此属性有特性 { [[Writable]]:
使用 Function.prototype.bind 创建的
20.2.5 HostHasSourceTextAvailable ( func )
HostHasSourceTextAvailable 的实现必须符合以下要求：
- 它必须相对于其参数是确定性的。每次使用特定的 func 作为参数调用时，它必须返回相同的结果。
HostHasSourceTextAvailable 的默认实现是返回
20.3 Boolean 对象
20.3.1 Boolean 构造器
Boolean
- 是 %Boolean%。
- 是
全局对象 的"Boolean" 属性的初始值。 - 当作为
构造器 调用时，创建并初始化一个新的 Boolean 对象。 - 当作为函数而不是作为
构造器 调用时，执行类型转换。 - 可以用作类定义中
extends子句的值。打算继承指定的 Boolean 行为的子类构造器 必须包含一个对 Boolean构造器 的super调用，以创建和初始化具有 [[BooleanData]] 内部槽的子类实例。
20.3.1.1 Boolean ( value )
此函数在被调用时执行以下步骤：
- 设 b 为
ToBoolean (value)。 - 如果 NewTarget 是
undefined ，返回 b。 - 设 O 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Boolean.prototype%" , « [[BooleanData]] »)。 - 设 O.[[BooleanData]] 为 b。
- 返回 O。
20.3.2 Boolean 构造器的属性
Boolean
- 有一个 [[Prototype]] 内部槽，其值是
%Function.prototype% 。 - 有以下属性：
20.3.2.1 Boolean.prototype
Boolean.prototype 的初始值是
此属性有特性 { [[Writable]]:
20.3.3 Boolean 原型对象的属性
Boolean 原型对象：
- 是 %Boolean.prototype%。
- 是一个
普通对象 。 - 本身是一个 Boolean 对象；它有一个 [[BooleanData]] 内部槽，值为
false 。 - 有一个 [[Prototype]] 内部槽，其值是
%Object.prototype% 。
20.3.3.1 Boolean.prototype.constructor
Boolean.prototype.constructor 的初始值是
20.3.3.2 Boolean.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 设 b 为 ?
ThisBooleanValue (this value)。 - 如果 b 是
true ，返回"true" ；否则返回"false" 。
20.3.3.3 Boolean.prototype.valueOf ( )
此方法在被调用时执行以下步骤：
- 返回 ?
ThisBooleanValue (this value)。
20.3.3.3.1 ThisBooleanValue ( value )
抽象操作 ThisBooleanValue 接受参数 value（一个
20.3.4 Boolean 实例的属性
Boolean 实例是从
20.4 Symbol 对象
20.4.1 Symbol 构造器
Symbol
- 是 %Symbol%。
- 是
全局对象 的"Symbol" 属性的初始值。 - 当作为函数调用时返回一个新的 Symbol 值。
- 不打算与
new操作符一起使用。 - 不打算被子类化。
- 可以用作类定义中
extends子句的值，但对它的super调用将导致异常。
20.4.1.1 Symbol ( [ description ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 不是
undefined ，抛出TypeError 异常。 - 如果 description 是
undefined ，设 descString 为undefined 。 - 否则，设 descString 为 ?
ToString (description)。 - 返回一个新的 Symbol，其 [[Description]] 是 descString。
20.4.2 Symbol 构造器的属性
Symbol
- 有一个 [[Prototype]] 内部槽，其值是
%Function.prototype% 。 - 有以下属性：
20.4.2.1 Symbol.asyncIterator
Symbol.asyncIterator 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.2.2 Symbol.for ( key )
此函数在被调用时执行以下步骤：
- 设 stringKey 为 ?
ToString (key)。 - 对于
GlobalSymbolRegistry 列表 的每个元素 e，执行- 如果 e.[[Key]] 是 stringKey， 返回 e.[[Symbol]]。
断言 ：GlobalSymbolRegistry 列表 当前不包含 stringKey 的条目。- 设 newSymbol 为一个新的 Symbol，其 [[Description]] 是 stringKey。
- 将 GlobalSymbolRegistry
记录 { [[Key]]: stringKey, [[Symbol]]: newSymbol } 追加到GlobalSymbolRegistry 列表 。 - 返回 newSymbol。
GlobalSymbolRegistry 列表是一个只能追加的
20.4.2.3 Symbol.hasInstance
Symbol.hasInstance 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.2.4 Symbol.isConcatSpreadable
Symbol.isConcatSpreadable 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.2.5 Symbol.iterator
Symbol.iterator 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.2.6 Symbol.keyFor ( sym )
此函数在被调用时执行以下步骤：
- 如果 sym
不是 Symbol ，抛出TypeError 异常。 - 返回
KeyForSymbol (sym)。
20.4.2.7 Symbol.match
Symbol.match 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.2.8 Symbol.matchAll
Symbol.matchAll 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.2.9 Symbol.prototype
Symbol.prototype 的初始值是
此属性有特性 { [[Writable]]:
20.4.2.10 Symbol.replace
Symbol.replace 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.2.11 Symbol.search
Symbol.search 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.2.12 Symbol.species
Symbol.species 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.2.13 Symbol.split
Symbol.split 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.2.14 Symbol.toPrimitive
Symbol.toPrimitive 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.2.15 Symbol.toStringTag
Symbol.toStringTag 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.2.16 Symbol.unscopables
Symbol.unscopables 的初始值是众所周知的符号
此属性有特性 { [[Writable]]:
20.4.3 Symbol 原型对象的属性
Symbol 原型对象：
- 是 %Symbol.prototype%。
- 是一个
普通对象 。 不是 Symbol 实例，并且没有 [[SymbolData]] 内部槽。- 有一个 [[Prototype]] 内部槽，其值是
%Object.prototype% 。
20.4.3.1 Symbol.prototype.constructor
Symbol.prototype.constructor 的初始值是
20.4.3.2 get Symbol.prototype.description
Symbol.prototype.description 是一个
- 设 s 为
this 值。 - 设 sym 为 ?
ThisSymbolValue (s)。 - 返回 sym.[[Description]]。
20.4.3.3 Symbol.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 设 sym 为 ?
ThisSymbolValue (this value)。 - 返回
SymbolDescriptiveString (sym)。
20.4.3.3.1 SymbolDescriptiveString ( sym )
抽象操作 SymbolDescriptiveString 接受参数 sym（一个 Symbol）并返回一个字符串。当被调用时执行以下步骤：
20.4.3.4 Symbol.prototype.valueOf ( )
此方法在被调用时执行以下步骤：
- 返回 ?
ThisSymbolValue (this value)。
20.4.3.4.1 ThisSymbolValue ( value )
抽象操作 ThisSymbolValue 接受参数 value（一个
- 如果 value
是一个 Symbol ，返回 value。 - 如果 value
是一个对象 且 value 有一个 [[SymbolData]] 内部槽，那么- 设 s 为 value.[[SymbolData]]。
断言 ：s是一个 Symbol 。- 返回 s。
- 抛出
TypeError 异常。
20.4.3.5 Symbol.prototype [ %Symbol.toPrimitive% ] ( hint )
此方法被 ECMAScript 语言操作符调用，以将 Symbol 对象转换为原始值。
当被调用时执行以下步骤：
- 返回 ?
ThisSymbolValue (this value)。
参数被忽略。
此属性有特性 { [[Writable]]:
此方法的
20.4.3.6 Symbol.prototype [ %Symbol.toStringTag% ]
此属性有特性 { [[Writable]]:
20.4.4 Symbol 实例的属性
Symbol 实例是从
20.4.5 Symbol 的抽象操作
20.4.5.1 KeyForSymbol ( sym )
抽象操作 KeyForSymbol 接受参数 sym（一个 Symbol）并返回一个字符串或
- 对于
GlobalSymbolRegistry 列表 的每个元素 e，执行- 如果
SameValue (e.[[Symbol]], sym) 是true ，返回 e.[[Key]]。
- 如果
断言 ：GlobalSymbolRegistry 列表 当前不包含 sym 的条目。- 返回
undefined 。
20.5 Error 对象
当运行时错误发生时，Error 对象的实例作为异常被抛出。Error 对象也可以作为用户定义异常类的基对象。
当 ECMAScript 实现检测到运行时错误时，它会抛出在
20.5.1 Error 构造器
Error
- 是 %Error%。
- 是
全局对象 的"Error" 属性的初始值。 - 当作为函数而不是作为
构造器 调用时，创建并初始化一个新的 Error 对象。因此函数调用Error(…)等同于具有相同参数的对象创建表达式new Error(…)。 - 可以用作类定义中
extends子句的值。打算继承指定的 Error 行为的子类构造器 必须包含一个对 Error构造器 的super调用，以创建和初始化具有 [[ErrorData]] 内部槽的子类实例。
20.5.1.1 Error ( message [ , options ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，设 newTarget 为活动函数对象 ；否则设 newTarget 为 NewTarget。 - 设 O 为 ?
OrdinaryCreateFromConstructor (newTarget,"%Error.prototype%" , « [[ErrorData]] »)。 - 如果 message 不是
undefined ，那么- 设 msg 为 ?
ToString (message)。 - 执行
CreateNonEnumerableDataPropertyOrThrow (O,"message" , msg)。
- 设 msg 为 ?
- 执行 ?
InstallErrorCause (O, options)。 - 返回 O。
20.5.2 Error 构造器的属性
Error
- 有一个 [[Prototype]] 内部槽，其值是
%Function.prototype% 。 - 有以下属性：
20.5.2.1 Error.prototype
Error.prototype 的初始值是
此属性有特性 { [[Writable]]:
20.5.3 Error 原型对象的属性
Error 原型对象：
- 是 %Error.prototype%。
- 是一个
普通对象 。 - 不是 Error 实例，并且没有 [[ErrorData]] 内部槽。
- 有一个 [[Prototype]] 内部槽，其值是
%Object.prototype% 。
20.5.3.1 Error.prototype.constructor
Error.prototype.constructor 的初始值是
20.5.3.2 Error.prototype.message
Error.prototype.message 的初始值是空字符串。
20.5.3.3 Error.prototype.name
Error.prototype.name 的初始值是
20.5.3.4 Error.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 设 O 为
this 值。 - 如果 O
不是对象 ，抛出TypeError 异常。 - 设 name 为 ?
Get (O,"name" )。 - 如果 name 是
undefined ，设 name 为"Error" ；否则设 name 为 ?ToString (name)。 - 设 msg 为 ?
Get (O,"message" )。 - 如果 msg 是
undefined ，设 msg 为空字符串；否则设 msg 为 ?ToString (msg)。 - 如果 name 是空字符串，返回 msg。
- 如果 msg 是空字符串，返回 name。
- 返回 name、代码单元 0x003A（冒号）、代码单元 0x0020（空格）和 msg 的
字符串连接 。
20.5.4 Error 实例的属性
Error 实例是从 Object.prototype.toString 中将 Error、AggregateError 和 NativeError 实例标识为
Error 对象。
20.5.5 本标准中使用的原生 Error 类型
当检测到运行时错误时，会抛出下面 NativeError 对象之一或 AggregateError 对象的新实例。所有 NativeError
对象共享相同的结构，如
20.5.5.1 EvalError
EvalError
此异常当前在本规范中未使用。保留此对象是为了与本规范的先前版本兼容。
20.5.5.2 RangeError
RangeError
表示一个不在允许值集合或范围内的值。
20.5.5.3 ReferenceError
ReferenceError
表示检测到无效引用。
20.5.5.4 SyntaxError
SyntaxError
表示发生了解析错误。
20.5.5.5 TypeError
TypeError
TypeError 用于表示不成功的操作，当其他 NativeError 对象都不适合表示失败原因时使用。
20.5.5.6 URIError
URIError
表示某个全局 URI 处理函数的使用方式与其定义不兼容。
20.5.6 NativeError 对象结构
这些对象中的每一个都具有下面描述的结构，仅在用作
对于每个错误对象，定义中对 NativeError 的引用应替换为
20.5.6.1 NativeError 构造器
每个 NativeError
- 当作为函数而不是作为
构造器 调用时，创建并初始化一个新的 NativeError 对象。将对象作为函数调用等同于使用相同参数将其作为构造器 调用。因此函数调用NativeError(…)等同于具有相同参数的对象创建表达式new NativeError(…)。 - 可以用作类定义中
extends子句的值。打算继承指定的 NativeError 行为的子类构造器 必须包含一个对 NativeError构造器 的super调用，以创建和初始化具有 [[ErrorData]] 内部槽的子类实例。
20.5.6.1.1 NativeError ( message [ , options ] )
每个 NativeError 函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，设 newTarget 为活动函数对象 ；否则设 newTarget 为 NewTarget。 - 设 O 为
?
OrdinaryCreateFromConstructor (newTarget,"%NativeError.prototype%", « [[ErrorData]] »)。 - 如果 message 不是
undefined ，那么- 设 msg 为 ?
ToString (message)。 - 执行
CreateNonEnumerableDataPropertyOrThrow (O,"message" , msg)。
- 设 msg 为 ?
- 执行 ?
InstallErrorCause (O, options)。 - 返回 O。
在步骤
20.5.6.2 NativeError 构造器的属性
每个 NativeError
- 有一个 [[Prototype]] 内部槽，其值是
%Error% 。 - 有一个
"name" 属性，其值是字符串值"NativeError" 。 - 有以下属性：
20.5.6.2.1 NativeError.prototype
NativeError.prototype 的初始值是一个 NativeError
原型对象（
此属性有特性 { [[Writable]]:
20.5.6.3 NativeError 原型对象的属性
每个 NativeError 原型对象：
- 是一个
普通对象 。 - 不是 Error 实例，并且没有 [[ErrorData]] 内部槽。
- 有一个 [[Prototype]] 内部槽，其值是
%Error.prototype% 。
20.5.6.3.1 NativeError.prototype.constructor
20.5.6.3.2 NativeError.prototype.message
给定 NativeError
20.5.6.3.3 NativeError.prototype.name
给定 NativeError
20.5.6.4 NativeError 实例的属性
NativeError 实例是从其 NativeError 原型对象继承属性的 Object.prototype.toString（
20.5.7 AggregateError 对象
20.5.7.1 AggregateError 构造器
AggregateError
- 是 %AggregateError%。
- 是
全局对象 的"AggregateError" 属性的初始值。 - 当作为函数而不是作为
构造器 调用时，创建并初始化一个新的 AggregateError 对象。因此函数调用AggregateError(…)等同于具有相同参数的对象创建表达式new AggregateError(…)。 - 可以用作类定义中
extends子句的值。打算继承指定的 AggregateError 行为的子类构造器 必须包含一个对 AggregateError构造器 的super调用，以创建和初始化具有 [[ErrorData]] 内部槽的子类实例。
20.5.7.1.1 AggregateError ( errors, message [ , options ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，设 newTarget 为活动函数对象 ；否则设 newTarget 为 NewTarget。 - 设 O 为 ?
OrdinaryCreateFromConstructor (newTarget,"%AggregateError.prototype%" , « [[ErrorData]] »)。 - 如果 message 不是
undefined ，那么- 设 msg 为 ?
ToString (message)。 - 执行
CreateNonEnumerableDataPropertyOrThrow (O,"message" , msg)。
- 设 msg 为 ?
- 执行 ?
InstallErrorCause (O, options)。 - 设 errorsList 为 ?
IteratorToList (?GetIterator (errors,sync ))。 - 执行 !
DefinePropertyOrThrow (O,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errorsList) })。 - 返回 O。
20.5.7.2 AggregateError 构造器的属性
AggregateError
- 有一个 [[Prototype]] 内部槽，其值是
%Error% 。 - 有以下属性：
20.5.7.2.1 AggregateError.prototype
AggregateError.prototype 的初始值是
此属性有特性 { [[Writable]]:
20.5.7.3 AggregateError 原型对象的属性
AggregateError 原型对象：
- 是 %AggregateError.prototype%。
- 是一个
普通对象 。 - 不是 Error 实例或 AggregateError 实例，并且没有 [[ErrorData]] 内部槽。
- 有一个 [[Prototype]] 内部槽，其值是
%Error.prototype% 。
20.5.7.3.1 AggregateError.prototype.constructor
AggregateError.prototype.constructor 的初始值是
20.5.7.3.2 AggregateError.prototype.message
AggregateError.prototype.message 的初始值是空字符串。
20.5.7.3.3 AggregateError.prototype.name
AggregateError.prototype.name 的初始值是
20.5.7.4 AggregateError 实例的属性
AggregateError 实例是从其 Object.prototype.toString（
20.5.8 Error 对象的抽象操作
20.5.8.1 InstallErrorCause ( O, options )
抽象操作 InstallErrorCause 接受参数 O（一个对象）和 options（一个
- 如果 options
是一个对象 且 ?HasProperty (options,"cause" ) 是true ，那么- 设 cause 为 ?
Get (options,"cause" )。 - 执行
CreateNonEnumerableDataPropertyOrThrow (O,"cause" , cause)。
- 设 cause 为 ?
- 返回
unused 。
21 数字和日期
21.1 Number 对象
21.1.1 Number 构造器
Number
- 是 %Number%。
- 是
全局对象 的"Number" 属性的初始值。 - 当作为
构造器 调用时，创建并初始化一个新的 Number 对象。 - 当作为函数而不是作为
构造器 调用时，执行类型转换。 - 可以用作类定义中
extends子句的值。打算继承指定的 Number 行为的子类构造器 必须包含一个对 Number构造器 的super调用，以创建和初始化具有 [[NumberData]] 内部槽的子类实例。
21.1.1.1 Number ( value )
此函数在被调用时执行以下步骤：
- 如果 value 存在，那么
- 否则，
- 设 n 为
+0 𝔽。
- 设 n 为
- 如果 NewTarget 是
undefined ，返回 n。 - 设 O 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Number.prototype%" , « [[NumberData]] »)。 - 设置 O.[[NumberData]] 为 n。
- 返回 O。
21.1.2 Number 构造器的属性
Number
- 有一个 [[Prototype]] 内部槽，其值是
%Function.prototype% 。 - 有以下属性：
21.1.2.1 Number.EPSILON
Number.EPSILON 的值是 1 与大于 1 的可表示为 Number 值的最小值之间差值的幅度的
此属性有特性 { [[Writable]]:
21.1.2.2 Number.isFinite ( number )
此函数在被调用时执行以下步骤：
21.1.2.3 Number.isInteger ( number )
此函数在被调用时执行以下步骤：
- 如果 number 是
整数 Number ，返回true 。 - 返回
false 。
21.1.2.4 Number.isNaN ( number )
此函数在被调用时执行以下步骤：
- 如果 number
不是 Number ，返回false 。 - 如果 number 是
NaN ，返回true 。 - 否则，返回
false 。
此函数与全局 isNaN 函数（
21.1.2.5 Number.isSafeInteger ( number )
此函数在被调用时执行以下步骤：
21.1.2.6 Number.MAX_SAFE_INTEGER
Number.MAX_SAFE_INTEGER 的值是
此属性有特性 { [[Writable]]:
21.1.2.7 Number.MAX_VALUE
Number.MAX_VALUE 的值是
此属性有特性 { [[Writable]]:
21.1.2.8 Number.MIN_SAFE_INTEGER
Number.MIN_SAFE_INTEGER 的值是
此属性有特性 { [[Writable]]:
21.1.2.9 Number.MIN_VALUE
Number.MIN_VALUE 的值是
在 Number.MIN_VALUE 的值必须是实现实际能表示的最小非零正值。
此属性有特性 { [[Writable]]:
21.1.2.10 Number.NaN
Number.NaN 的值是
此属性有特性 { [[Writable]]:
21.1.2.11 Number.NEGATIVE_INFINITY
Number.NEGATIVE_INFINITY 的值是
此属性有特性 { [[Writable]]:
21.1.2.12 Number.parseFloat ( string )
21.1.2.13 Number.parseInt ( string, radix )
21.1.2.14 Number.POSITIVE_INFINITY
Number.POSITIVE_INFINITY 的值是
此属性有特性 { [[Writable]]:
21.1.2.15 Number.prototype
Number.prototype 的初始值是
此属性有特性 { [[Writable]]:
21.1.3 Number 原型对象的属性
Number 原型对象：
- 是 %Number.prototype%。
- 是一个
普通对象 。 - 本身是一个 Number 对象；它有一个 [[NumberData]] 内部槽，值为
+0 𝔽。 - 有一个 [[Prototype]] 内部槽，其值是
%Object.prototype% 。
除非明确说明，下面定义的 Number 原型对象的方法不是通用的，传递给它们的
方法规范中的短语"此 Number 值"是指通过将方法调用的
21.1.3.1 Number.prototype.constructor
Number.prototype.constructor 的初始值是
21.1.3.2 Number.prototype.toExponential ( fractionDigits )
此方法返回一个字符串，包含以十进制指数记法表示的此 Number 值，有效数字的小数点前有一位数字，小数点后有 fractionDigits 位数字。如果
fractionDigits 是
当被调用时执行以下步骤：
- 设 x 为 ?
ThisNumberValue (this value)。 - 设 f 为 ?
ToIntegerOrInfinity (fractionDigits)。 断言 ：如果 fractionDigits 是undefined ，那么 f 是 0。- 如果 x 不是
有限的 ，返回Number::toString (x, 10)。 - 如果 f < 0 或 f > 100，抛出
RangeError 异常。 - 设置 x 为
ℝ (x)。 - 设 s 为空字符串。
- 如果 x < 0，那么
- 设置 s 为
"-" 。 - 设置 x 为 -x。
- 设置 s 为
- 如果 x = 0，那么
- 设 m 为由 f + 1 个代码单元 0x0030（数字零）组成的字符串值。
- 设 e 为 0。
- 否则，
- 如果 fractionDigits 不是
undefined ，那么- 设 e 和 n 为
整数 ，使得 10f ≤ n < 10f + 1 且 n × 10e - f - x 尽可能接近零。如果有两组这样的 e 和 n，选择使 n × 10e - f 更大的 e 和 n。
- 设 e 和 n 为
- 否则，
- 设 m 为由 n 的十进制表示的数字组成的字符串值（按顺序，没有前导零）。
- 如果 fractionDigits 不是
- 如果 f ≠ 0，那么
- 设 a 为 m 的第一个代码单元。
- 设 b 为 m 的其他 f 个代码单元。
- 设置 m 为 a、
"." 和 b 的字符串连接 。
- 如果 e = 0，那么
- 设 c 为
"+" 。 - 设 d 为
"0" 。
- 设 c 为
- 否则，
- 如果 e > 0，那么
- 设 c 为
"+" 。
- 设 c 为
- 否则，
断言 ：e < 0。- 设 c 为
"-" 。 - 设置 e 为 -e。
- 设 d 为由 e 的十进制表示的数字组成的字符串值（按顺序，没有前导零）。
- 如果 e > 0，那么
- 设置 m 为 m、
"e" 、c 和 d 的字符串连接 。 - 返回 s 和 m 的
字符串连接 。
21.1.3.3 Number.prototype.toFixed ( fractionDigits )
此方法返回一个字符串，包含以十进制定点记法表示的此 Number 值，小数点后有 fractionDigits 位数字。如果
fractionDigits 是
当被调用时执行以下步骤：
- 设 x 为 ?
ThisNumberValue (this value)。 - 设 f 为 ?
ToIntegerOrInfinity (fractionDigits)。 断言 ：如果 fractionDigits 是undefined ，那么 f 是 0。- 如果 f 不是
有限的 ，抛出RangeError 异常。 - 如果 f < 0 或 f > 100，抛出
RangeError 异常。 - 如果 x 不是
有限的 ，返回Number::toString (x, 10)。 - 设置 x 为
ℝ (x)。 - 设 s 为空字符串。
- 如果 x < 0，那么
- 设置 s 为
"-" 。 - 设置 x 为 -x。
- 设置 s 为
- 如果 x ≥ 1021，那么
- 否则，
- 返回 s 和 m 的
字符串连接 。
对于某些值，toFixed 的输出可能比 toString 更精确，因为 toString
只打印足够的有效数字来区分该数字与相邻的 Number 值。例如，
(1000000000000000128).toString() 返回
(1000000000000000128).toFixed(0) 返回
21.1.3.4 Number.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按照 ECMA-402 规范中的规定实现此方法。如果 ECMAScript 实现不包含 ECMA-402 API，则使用此方法的以下规范：
此方法产生一个字符串值，该值表示根据 toString 相同的内容。
此方法的可选参数的含义在 ECMA-402 规范中定义；不包含 ECMA-402 支持的实现不得将这些参数位置用于任何其他用途。
21.1.3.5 Number.prototype.toPrecision ( precision )
此方法返回一个字符串，包含以十进制指数记法表示的此 Number 值，有效数字的小数点前有一位数字，小数点后有
当被调用时执行以下步骤：
- 设 x 为 ?
ThisNumberValue (this value)。 - 如果 precision 是
undefined ，返回 !ToString (x)。 - 设 p 为 ?
ToIntegerOrInfinity (precision)。 - 如果 x 不是
有限的 ，返回Number::toString (x, 10)。 - 如果 p < 1 或 p > 100，抛出
RangeError 异常。 - 设置 x 为
ℝ (x)。 - 设 s 为空字符串。
- 如果 x < 0，那么
- 设置 s 为代码单元 0x002D（连字符减号）。
- 设置 x 为 -x。
- 如果 x = 0，那么
- 设 m 为由 p 个代码单元 0x0030（数字零）组成的字符串值。
- 设 e 为 0。
- 否则，
- 设 e 和 n 为
整数 ，使得 10p - 1 ≤ n < 10p 且 n × 10e - p + 1 - x 尽可能接近零。如果有两组这样的 e 和 n，选择使 n × 10e - p + 1 更大的 e 和 n。 - 设 m 为由 n 的十进制表示的数字组成的字符串值（按顺序，没有前导零）。
- 如果 e < -6 或 e ≥ p，那么
- 设 e 和 n 为
- 如果 e = p - 1，返回 s 和 m 的
字符串连接 。 - 如果 e ≥ 0，那么
- 设置 m 为 m 的前 e + 1 个代码单元、代码单元 0x002E（句号）和
m 的其余 p - (e + 1) 个代码单元的
字符串连接 。
- 设置 m 为 m 的前 e + 1 个代码单元、代码单元 0x002E（句号）和
m 的其余 p - (e + 1) 个代码单元的
- 否则，
- 设置 m 为代码单元 0x0030（数字零）、代码单元 0x002E（句号）、-(e + 1) 个代码单元
0x0030（数字零）和字符串 m 的
字符串连接 。
- 设置 m 为代码单元 0x0030（数字零）、代码单元 0x002E（句号）、-(e + 1) 个代码单元
0x0030（数字零）和字符串 m 的
- 返回 s 和 m 的
字符串连接 。
21.1.3.6 Number.prototype.toString ( [ radix ] )
此方法在被调用时执行以下步骤：
- 设 x 为 ?
ThisNumberValue (this value)。 - 如果 radix 是
undefined ，设 radixMV 为 10。 - 否则，设 radixMV 为 ?
ToIntegerOrInfinity (radix)。 - 如果 radixMV 不在从 2 到 36 的
包含区间 内，抛出RangeError 异常。 - 返回
Number::toString (x, radixMV)。
此方法不是通用的；如果其
此方法的
21.1.3.7 Number.prototype.valueOf ( )
- 返回 ?
ThisNumberValue (this value)。
21.1.3.7.1 ThisNumberValue ( value )
抽象操作 ThisNumberValue 接受参数 value（一个
21.1.4 Number 实例的属性
Number 实例是从
21.2 BigInt 对象
21.2.1 BigInt 构造器
BigInt
- 是 %BigInt%。
- 是
全局对象 的"BigInt" 属性的初始值。 - 当作为函数而不是作为
构造器 调用时，执行类型转换。 - 不打算与
new操作符一起使用或被子类化。它可以用作类定义中extends子句的值，但对 BigInt构造器 的super调用将导致异常。
21.2.1.1 BigInt ( value )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 不是
undefined ，抛出TypeError 异常。 - 设 prim 为 ?
ToPrimitive (value,number )。 - 如果 prim
是 Number ，返回 ?NumberToBigInt (prim)。 - 否则，返回 ?
ToBigInt (prim)。
21.2.1.1.1 NumberToBigInt ( number )
抽象操作 NumberToBigInt 接受参数 number（一个 Number），并返回一个
21.2.2 BigInt 构造器的属性
BigInt
- 有一个 [[Prototype]] 内部槽，其值是
%Function.prototype% 。 - 有以下属性：
21.2.2.1 BigInt.asIntN ( bits, bigint )
此函数在被调用时执行以下步骤：
21.2.2.2 BigInt.asUintN ( bits, bigint )
此函数在被调用时执行以下步骤：
21.2.2.3 BigInt.prototype
BigInt.prototype 的初始值是
此属性有特性 { [[Writable]]:
21.2.3 BigInt 原型对象的属性
BigInt 原型对象：
- 是 %BigInt.prototype%。
- 是一个
普通对象 。 不是 BigInt 对象；它没有 [[BigIntData]] 内部槽。- 有一个 [[Prototype]] 内部槽，其值是
%Object.prototype% 。
方法规范中的短语"此 BigInt 值"是指通过将方法调用的
21.2.3.1 BigInt.prototype.constructor
BigInt.prototype.constructor 的初始值是
21.2.3.2 BigInt.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按照 ECMA-402 规范中的规定实现此方法。如果 ECMAScript 实现不包含 ECMA-402 API，则使用此方法的以下规范：
此方法产生一个字符串值，该值表示根据 toString 相同的内容。
此方法的可选参数的含义在 ECMA-402 规范中定义；不包含 ECMA-402 支持的实现不得将这些参数位置用于任何其他用途。
21.2.3.3 BigInt.prototype.toString ( [ radix ] )
此方法在被调用时执行以下步骤：
- 设 x 为 ?
ThisBigIntValue (this value)。 - 如果 radix 是
undefined ，设 radixMV 为 10。 - 否则，设 radixMV 为 ?
ToIntegerOrInfinity (radix)。 - 如果 radixMV 不在从 2 到 36 的
包含区间 内，抛出RangeError 异常。 - 返回
BigInt::toString (x, radixMV)。
此方法不是通用的；如果其
21.2.3.4 BigInt.prototype.valueOf ( )
- 返回 ?
ThisBigIntValue (this value)。
21.2.3.4.1 ThisBigIntValue ( value )
抽象操作 ThisBigIntValue 接受参数 value（一个
21.2.3.5 BigInt.prototype [ %Symbol.toStringTag% ]
此属性有特性 { [[Writable]]:
21.2.4 BigInt 实例的属性
BigInt 实例是从
21.3 Math 对象
Math 对象：
- 是 %Math%。
- 是
全局对象 的"Math" 属性的初始值。 - 是一个
普通对象 。 - 有一个 [[Prototype]] 内部槽，其值是
%Object.prototype% 。 - 不是
函数对象 。 - 没有 [[Construct]] 内部方法；它不能与
new操作符一起用作构造器 。 - 没有 [[Call]] 内部方法；它不能作为函数被调用。
21.3.1 Math 对象的值属性
21.3.1.1 Math.E
e（自然对数的底）的
此属性有特性 { [[Writable]]:
21.3.1.2 Math.LN10
10 的自然对数的
此属性有特性 { [[Writable]]:
21.3.1.3 Math.LN2
2 的自然对数的
此属性有特性 { [[Writable]]:
21.3.1.4 Math.LOG10E
e（自然对数的底）的以 10 为底的对数的
此属性有特性 { [[Writable]]:
Math.LOG10E 的值约为 Math.LN10 值的倒数。
21.3.1.5 Math.LOG2E
e（自然对数的底）的以 2 为底的对数的
此属性有特性 { [[Writable]]:
Math.LOG2E 的值约为 Math.LN2 值的倒数。
21.3.1.6 Math.PI
π（圆的周长与其直径的比值）的
此属性有特性 { [[Writable]]:
21.3.1.7 Math.SQRT1_2
½ 的平方根的
此属性有特性 { [[Writable]]:
Math.SQRT1_2 的值约为 Math.SQRT2 值的倒数。
21.3.1.8 Math.SQRT2
2 的平方根的
此属性有特性 { [[Writable]]:
21.3.1.9 Math [ %Symbol.toStringTag% ]
此属性有特性 { [[Writable]]:
21.3.2 Math 对象的函数属性
函数
acos、acosh、asin、asinh、atan、atanh、atan2、cbrt、cos、cosh、exp、expm1、hypot、log、log1p、log2、log10、pow、random、sin、sinh、tan
和 tanh
的行为在此处未被精确指定，除了要求对表示感兴趣的边界情况的某些参数值有特定结果。对于其他参数值，这些函数意图计算熟悉的数学函数结果的近似值，但在近似算法的选择上允许一定的灵活性。总的意图是实现者应该能够在给定硬件平台上为
ECMAScript 使用与该平台上 C 程序员可用的相同数学库。
虽然算法的选择留给实现，但建议（但不是本标准规定的）实现使用 fdlibm 中，这是来自 Sun Microsystems 的可自由分发的数学库（http://www.netlib.org/fdlibm）。
21.3.2.1 Math.abs ( x )
此函数返回 x 的绝对值；结果与 x 具有相同的量级但符号为正。
当被调用时执行以下步骤：
- 设 n 为 ?
ToNumber (x)。 - 如果 n 是
NaN ，返回NaN 。 - 如果 n 是
-0 𝔽，返回+0 𝔽。 - 如果 n 是
-∞ 𝔽，返回+∞ 𝔽。 - 如果 n <
-0 𝔽，返回 -n。 - 返回 n。
21.3.2.2 Math.acos ( x )
此函数返回 x 的反余弦值。结果以弧度表示，在从
它在被调用时执行以下步骤：
21.3.2.3 Math.acosh ( x )
此函数返回 x 的反双曲余弦值。
它在被调用时执行以下步骤：
21.3.2.4 Math.asin ( x )
此函数返回 x 的反正弦值。结果以弧度表示，在从
它在被调用时执行以下步骤：
21.3.2.5 Math.asinh ( x )
此函数返回 x 的反双曲正弦值。
它在被调用时执行以下步骤：
21.3.2.6 Math.atan ( x )
此函数返回 x 的反正切值。结果以弧度表示，在从
它在被调用时执行以下步骤：
21.3.2.7 Math.atanh ( x )
此函数返回 x 的反双曲正切值。
它在被调用时执行以下步骤：
21.3.2.8 Math.atan2 ( y, x )
此函数返回参数 y 和 x 的商
它在被调用时执行以下步骤：
- 设 ny 为 ?
ToNumber (y)。 - 设 nx 为 ?
ToNumber (x)。 - 如果 ny 是
NaN 或 nx 是NaN ，返回NaN 。 - 如果 ny 是
+∞ 𝔽，则 - 如果 ny 是
-∞ 𝔽，则 - 如果 ny 是
+0 𝔽，则- 如果 nx >
+0 𝔽 或 nx 是+0 𝔽，返回+0 𝔽。 - 返回一个
实现近似 的 Number 值，表示 π。
- 如果 nx >
- 如果 ny 是
-0 𝔽，则- 如果 nx >
+0 𝔽 或 nx 是+0 𝔽，返回-0 𝔽。 - 返回一个
实现近似 的 Number 值，表示 -π。
- 如果 nx >
断言 ： ny 是有限的 且既不是+0 𝔽 也不是-0 𝔽。- 如果 ny >
+0 𝔽，则 - 如果 ny <
-0 𝔽，则 断言 ： nx 是有限的 且既不是+0 𝔽 也不是-0 𝔽。- 设 r 为
abs (ℝ (ny) /ℝ (nx)) 的反正切值。 - 如果 nx <
-0 𝔽，则- 如果 ny >
+0 𝔽，设 r 为 π - r。 - 否则，设 r 为 -π + r。
- 如果 ny >
- 否则，
- 如果 ny <
-0 𝔽，设 r 为 -r。
- 如果 ny <
- 返回一个
实现近似 的 Number 值，表示 r。
21.3.2.9 Math.cbrt ( x )
此函数返回 x 的立方根。
它在被调用时执行以下步骤：
21.3.2.10 Math.ceil ( x )
此函数返回不小于 x 的最小（最接近 -∞）
它在被调用时执行以下步骤：
Math.ceil(x) 的值与
-Math.floor(-x) 的值相同。
21.3.2.11 Math.clz32 ( x )
此函数在被调用时执行以下步骤：
如果 n 是
21.3.2.12 Math.cos ( x )
此函数返回 x 的余弦值。参数以弧度表示。
它在被调用时执行以下步骤：
21.3.2.13 Math.cosh ( x )
此函数返回 x 的双曲余弦值。
它在被调用时执行以下步骤：
Math.cosh(x) 的值与
(Math.exp(x) + Math.exp(-x)) / 2 的值相同。
21.3.2.14 Math.exp ( x )
此函数返回 x 的指数函数（e 的 x 次幂，其中 e 是自然对数的底）。
它在被调用时执行以下步骤：
21.3.2.15 Math.expm1 ( x )
此函数返回从 x 的指数函数（e 的 x 次幂，其中 e 是自然对数的底）中减去 1 的结果。该结果以一种即使当 x 的值接近 0 时也很准确的方式计算。
它在被调用时执行以下步骤：
21.3.2.16 Math.floor ( x )
此函数返回不大于 x 的最大（最接近 +∞）
它在被调用时执行以下步骤：
Math.floor(x) 的值与
-Math.ceil(-x) 的值相同。
21.3.2.17 Math.fround ( x )
此函数在被调用时执行以下步骤：
- 设 n 为 ?
ToNumber (x)。 - 如果 n 是
NaN ，返回NaN 。 - 如果 n 是
+0 𝔽，-0 𝔽，+∞ 𝔽，或-∞ 𝔽 之一，返回 n。 - 设 n32 为使用 roundTiesToEven 模式将 n 转换为
IEEE 754-2019 binary32 格式的结果。 - 设 n64 为将 n32 转换为
IEEE 754-2019 binary64 格式的结果。 - 返回对应于 n64 的 ECMAScript Number 值。
21.3.2.18 Math.f16round ( x )
此函数在被调用时执行以下步骤：
- 设 n 为 ?
ToNumber (x)。 - 如果 n 是
NaN ，返回NaN 。 - 如果 n 是
+0 𝔽，-0 𝔽，+∞ 𝔽，或-∞ 𝔽 之一，返回 n。 - 设 n16 为使用 roundTiesToEven 模式将 n 转换为
IEEE 754-2019 binary16 格式的结果。 - 设 n64 为将 n16 转换为
IEEE 754-2019 binary64 格式的结果。 - 返回对应于 n64 的 ECMAScript Number 值。
此操作与先转换为 binary32 再转换为 binary16 是不同的，因为可能存在双重舍入：例如，考虑数字 k =
并非所有平台都提供从 binary64 转换为 binary16 的原生支持。有各种库可以提供此功能，包括 MIT 许可的 half 库。或者，可以首先在 roundTiesToEven 下从 binary64 转换为 binary32，然后检查结果是否可能导致不正确的双重舍入。可能导致问题的情况可以通过调整 binary32 值的尾数来明确处理，使其成为在 roundTiesToOdd 下执行初始转换时会产生的值。然后在 roundTiesToEven 下将调整后的值转换为 binary16 就会产生正确的值。
21.3.2.19 Math.hypot ( ...args )
给定零个或多个参数，此函数返回其参数的平方和的平方根。
它在被调用时执行以下步骤：
- 设 coerced 为一个新的空
列表 。 - 对于 args 的每个元素 arg，执行
- 设 n 为 ?
ToNumber (arg)。 - 将 n 追加到 coerced。
- 设 n 为 ?
- 对于 coerced 的每个元素 number，执行
- 如果 number 是
+∞ 𝔽 或-∞ 𝔽，返回+∞ 𝔽。
- 如果 number 是
- 设 onlyZero 为
true 。 - 对于 coerced 的每个元素 number，执行
- 如果 number 是
NaN ，返回NaN 。 - 如果 number 既不是
+0 𝔽 也不是-0 𝔽，设 onlyZero 为false 。
- 如果 number 是
- 如果 onlyZero 是
true ，返回+0 𝔽。 - 返回一个
实现近似 的 Number 值，表示 coerced 元素的数学值 的平方和的平方根。
此函数的
实现应当注意避免当此函数以两个或更多参数调用时，在朴素实现中容易发生的溢出和下溢导致的精度损失。
21.3.2.20 Math.imul ( x, y )
此函数在被调用时执行以下步骤：
21.3.2.21 Math.log ( x )
此函数返回 x 的自然对数。
它在被调用时执行以下步骤：
21.3.2.22 Math.log1p ( x )
此函数返回 1 + x 的自然对数。该结果以一种即使当 x 的值接近零时也很准确的方式计算。
它在被调用时执行以下步骤：
21.3.2.23 Math.log10 ( x )
此函数返回 x 的以 10 为底的对数。
它在被调用时执行以下步骤：
21.3.2.24 Math.log2 ( x )
此函数返回 x 的以 2 为底的对数。
它在被调用时执行以下步骤：
21.3.2.25 Math.max ( ...args )
给定零个或多个参数，此函数对每个参数调用
它在被调用时执行以下步骤：
确定最大值的值比较使用
此函数的
21.3.2.26 Math.min ( ...args )
给定零个或多个参数，此函数对每个参数调用
它在被调用时执行以下步骤：
确定最小值的值比较使用
此函数的
21.3.2.27 Math.pow ( base, exponent )
此函数在被调用时执行以下步骤：
- 设 base 为 ?
ToNumber (base)。 - 设 exponent 为 ?
ToNumber (exponent)。 - 返回
Number::exponentiate (base, exponent)。
21.3.2.28 Math.random ( )
此函数返回一个具有正号的 Number 值，大于或等于
为不同Math.random 函数必须从连续调用中产生不同的值序列。
21.3.2.29 Math.round ( x )
此函数返回最接近 x 且为整数的 Number 值。如果两个
它在被调用时执行以下步骤：
Math.round(3.5) 返回 4，但 Math.round(-3.5) 返回 -3。
Math.round(x) 的值并不总是与
Math.floor(x + 0.5) 的值相同。当 x 是
x 小于
Math.round(x) 返回
Math.floor(x + 0.5) 返回
Math.round(x) 也可能因为计算
x + 0.5 时的内部舍入而与
Math.floor(x + 0.5) 的值不同。
21.3.2.30 Math.sign ( x )
此函数返回 x 的符号，指示 x 是正数、负数还是零。
它在被调用时执行以下步骤：
- 设 n 为 ?
ToNumber (x)。 - 如果 n 是
NaN ，+0 𝔽，或-0 𝔽 之一，返回 n。 - 如果 n <
-0 𝔽，返回-1 𝔽。 - 返回
1 𝔽。
21.3.2.31 Math.sin ( x )
此函数返回 x 的正弦值。参数以弧度表示。
它在被调用时执行以下步骤：
21.3.2.32 Math.sinh ( x )
此函数返回 x 的双曲正弦值。
它在被调用时执行以下步骤：
Math.sinh(x) 的值与
(Math.exp(x) - Math.exp(-x)) / 2 的值相同。
21.3.2.33 Math.sqrt ( x )
此函数返回 x 的平方根。
它在被调用时执行以下步骤：
21.3.2.34 Math.tan ( x )
此函数返回 x 的正切值。参数以弧度表示。
它在被调用时执行以下步骤：
21.3.2.35 Math.tanh ( x )
此函数返回 x 的双曲正切值。
它在被调用时执行以下步骤：
Math.tanh(x) 的值与
(Math.exp(x) - Math.exp(-x)) / (Math.exp(x) + Math.exp(-x)) 的值相同。
21.3.2.36 Math.trunc ( x )
此函数返回数字 x 的整数部分，移除任何小数位。如果 x 已经是整数，结果就是 x。
它在被调用时执行以下步骤：
21.4 Date 对象
21.4.1 Date 对象概述和抽象操作的定义
以下
21.4.1.1 时间值和时间范围
ECMAScript 中的时间测量类似于 POSIX 中的时间测量，特别是共享以前推格里高利历为基础的定义，以 1970 年 1 月 1 日 UTC 午夜开始为纪元，并且将每一天计算为恰好 86,400 秒（每秒为 1000 毫秒）。
ECMAScript 时间值
时间值不考虑 UTC 闰秒——没有时间值表示正闰秒内的瞬间，并且有时间值表示被负闰秒从 UTC 时间线中移除的瞬间。然而，时间值的定义仍然产生与 UTC 的分段对齐，仅在闰秒边界处有不连续性，在闰秒之外没有差异。
Number 可以精确表示从 -9,007,199,254,740,992 到
9,007,199,254,740,992 的所有
1970 年 1 月 1 日 UTC 午夜开始的确切时刻由时间值
在前推格里高利历中，闰年恰好是那些既能被 4 整除，又能被 400 整除或不能被 100 整除的年份。
前推格里高利历的 400 年周期包含 97 个闰年。这产生平均每年 365.2425 天，即 31,556,952,000 毫秒。因此，Number 能以毫秒精度精确表示的最大范围大约是相对于 1970 年的 -285,426 到 285,426 年。本节中指定的时间值支持的较小范围大约是相对于 1970 年的 -273,790 到 273,790 年。
21.4.1.2 时间相关常量
这些常量被以下部分的算法引用。
21.4.1.3 Day ( t )
抽象操作 Day 接受参数 t（一个
21.4.1.4 TimeWithinDay ( t )
抽象操作 TimeWithinDay 接受参数 t（一个
21.4.1.5 DaysInYear ( y )
抽象操作 DaysInYear 接受参数 y（一个
21.4.1.6 DayFromYear ( y )
抽象操作 DayFromYear 接受参数 y（一个
- 设 ry 为
ℝ (y)。 - 注意：在以下步骤中，
numYears1、numYears4、numYears100 和
numYears400 分别表示在
纪元 和年份 y 开始之间发生的可被 1、4、100 和 400 整除的年数。如果 y 在纪元 之前，该数字为负数。 - 设 numYears1 为 (ry - 1970)。
- 设 numYears4 为
floor ((ry - 1969) / 4)。 - 设 numYears100 为
floor ((ry - 1901) / 100)。 - 设 numYears400 为
floor ((ry - 1601) / 400)。 - 返回
𝔽 (365 × numYears1 + numYears4 - numYears100 + numYears400)。
21.4.1.7 TimeFromYear ( y )
抽象操作 TimeFromYear 接受参数 y（一个
- 返回
msPerDay ×DayFromYear (y)。
21.4.1.8 YearFromTime ( t )
抽象操作 YearFromTime 接受参数 t（一个
- 返回最大的
整数 Number y（最接近 +∞），使得TimeFromYear (y) ≤ t。
21.4.1.9 DayWithinYear ( t )
抽象操作 DayWithinYear 接受参数 t（一个
- 返回
Day (t) -DayFromYear (YearFromTime (t))。
21.4.1.10 InLeapYear ( t )
抽象操作 InLeapYear 接受参数 t（一个
- 如果
DaysInYear (YearFromTime (t)) 是366 𝔽，返回1 𝔽；否则返回+0 𝔽。
21.4.1.11 MonthFromTime ( t )
抽象操作 MonthFromTime 接受参数 t（一个
- 设 inLeapYear 为
InLeapYear (t)。 - 设 dayWithinYear 为
DayWithinYear (t)。 - 如果 dayWithinYear <
31 𝔽，返回+0 𝔽。 - 如果 dayWithinYear <
59 𝔽 + inLeapYear，返回1 𝔽。 - 如果 dayWithinYear <
90 𝔽 + inLeapYear，返回2 𝔽。 - 如果 dayWithinYear <
120 𝔽 + inLeapYear，返回3 𝔽。 - 如果 dayWithinYear <
151 𝔽 + inLeapYear，返回4 𝔽。 - 如果 dayWithinYear <
181 𝔽 + inLeapYear，返回5 𝔽。 - 如果 dayWithinYear <
212 𝔽 + inLeapYear，返回6 𝔽。 - 如果 dayWithinYear <
243 𝔽 + inLeapYear，返回7 𝔽。 - 如果 dayWithinYear <
273 𝔽 + inLeapYear，返回8 𝔽。 - 如果 dayWithinYear <
304 𝔽 + inLeapYear，返回9 𝔽。 - 如果 dayWithinYear <
334 𝔽 + inLeapYear，返回10 𝔽。 断言 ： dayWithinYear <365 𝔽 + inLeapYear。- 返回
11 𝔽。
21.4.1.12 DateFromTime ( t )
抽象操作 DateFromTime 接受参数 t（一个
- 设 inLeapYear 为
InLeapYear (t)。 - 设 dayWithinYear 为
DayWithinYear (t)。 - 设 month 为
MonthFromTime (t)。 - 如果 month 是
+0 𝔽，返回 dayWithinYear +1 𝔽。 - 如果 month 是
1 𝔽，返回 dayWithinYear -30 𝔽。 - 如果 month 是
2 𝔽，返回 dayWithinYear -58 𝔽 - inLeapYear。 - 如果 month 是
3 𝔽，返回 dayWithinYear -89 𝔽 - inLeapYear。 - 如果 month 是
4 𝔽，返回 dayWithinYear -119 𝔽 - inLeapYear。 - 如果 month 是
5 𝔽，返回 dayWithinYear -150 𝔽 - inLeapYear。 - 如果 month 是
6 𝔽，返回 dayWithinYear -180 𝔽 - inLeapYear。 - 如果 month 是
7 𝔽，返回 dayWithinYear -211 𝔽 - inLeapYear。 - 如果 month 是
8 𝔽，返回 dayWithinYear -242 𝔽 - inLeapYear。 - 如果 month 是
9 𝔽，返回 dayWithinYear -272 𝔽 - inLeapYear。 - 如果 month 是
10 𝔽，返回 dayWithinYear -303 𝔽 - inLeapYear。 断言 ： month 是11 𝔽。- 返回 dayWithinYear -
333 𝔽 - inLeapYear。
21.4.1.13 WeekDay ( t )
抽象操作 WeekDay 接受参数 t（一个
21.4.1.14 HourFromTime ( t )
抽象操作 HourFromTime 接受参数 t（一个
21.4.1.15 MinFromTime ( t )
抽象操作 MinFromTime 接受参数 t（一个
- 返回
𝔽 (floor (ℝ (t /msPerMinute ))模 MinutesPerHour )。
21.4.1.16 SecFromTime ( t )
抽象操作 SecFromTime 接受参数 t（一个
- 返回
𝔽 (floor (ℝ (t /msPerSecond ))模 SecondsPerMinute )。
21.4.1.17 msFromTime ( t )
抽象操作 msFromTime 接受参数 t（一个
- 返回
𝔽 (ℝ (t)模 ℝ (msPerSecond ))。
21.4.1.18 GetUTCEpochNanoseconds ( year, month, day, hour, minute, second, millisecond, microsecond, nanosecond )
抽象操作 GetUTCEpochNanoseconds 接受参数 year（一个
21.4.1.19 时区标识符
ECMAScript 中的时区由时区标识符表示，它们是完全由在从
0x0000 到 0x007F 的
主要时区标识符是可用命名时区的首选标识符。 非主要时区标识符是不是主要时区标识符的可用命名时区标识符。 可用命名时区标识符要么是主要时区标识符，要么是非主要时区标识符。 每个可用命名时区标识符恰好与一个可用命名时区关联。 每个可用命名时区恰好与一个主要时区标识符和零个或多个非主要时区标识符关联。
ECMAScript 实现必须支持标识符为
遵循 ECMA-402 国际化 API 规范中描述的时区要求的实现称为时区感知的。
时区感知实现必须支持对应于 IANA 时区数据库的 Zone 和 Link 名称的可用命名时区，并且仅支持这些名称。
在时区感知实现中，主要时区标识符是 Zone 名称，非主要时区标识符是 Link 名称，分别在 IANA 时区数据库中，除非被 ECMA-402 规范中指定的
21.4.1.20 GetNamedTimeZoneEpochNanoseconds ( timeZoneIdentifier, year, month, day, hour, minute, second, millisecond, microsecond, nanosecond )
当输入表示由于负时区转换（例如夏令时结束或由于时区规则变更导致时区偏移减少）而多次出现的本地时间时，返回的
GetNamedTimeZoneEpochNanoseconds 的默认实现，用于不包含任何时区本地政治规则的 ECMAScript 实现，在被调用时执行以下步骤：
断言 ： timeZoneIdentifier 是"UTC" 。- 设 epochNanoseconds 为
GetUTCEpochNanoseconds (year, month, day, hour, minute, second, millisecond, microsecond, nanosecond)。 - 返回 « epochNanoseconds »。
2017 年 11 月 5 日在 America/New_York 的凌晨 1:30 重复了两次，所以
GetNamedTimeZoneEpochNanoseconds(
2017 年 3 月 12 日在 America/New_York 的凌晨 2:30 不存在，所以
GetNamedTimeZoneEpochNanoseconds(
21.4.1.21 GetNamedTimeZoneOffsetNanoseconds ( timeZoneIdentifier, epochNanoseconds )
返回的
GetNamedTimeZoneOffsetNanoseconds 的默认实现，用于不包含任何时区本地政治规则的 ECMAScript 实现，在被调用时执行以下步骤：
断言 ： timeZoneIdentifier 是"UTC" 。- 返回 0。
时区偏移值可能是正数或负数。
21.4.1.22 时区标识符记录
时区标识符记录是一个
时区标识符记录具有
如果 [[Identifier]] 是一个
21.4.1.23 AvailableNamedTimeZoneIdentifiers ( )
21.4.1.24 SystemTimeZoneIdentifier ( )
为了确保实现在 Date 对象的方法中通常提供的功能级别，建议 SystemTimeZoneIdentifier 返回对应于
例如，如果
21.4.1.25 LocalTime ( t )
抽象操作 LocalTime 接受参数 t（一个
- 设 systemTimeZoneIdentifier 为
SystemTimeZoneIdentifier ()。 - 如果
IsTimeZoneOffsetString (systemTimeZoneIdentifier) 是true ，那么- 设 offsetNs 为
ParseTimeZoneOffsetString (systemTimeZoneIdentifier)。
- 设 offsetNs 为
- 否则，
- 设 offsetNs 为
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier,ℤ (ℝ (t) × 106))。
- 设 offsetNs 为
- 设 offsetMs 为
truncate (offsetNs / 106)。 - 返回 t +
𝔽 (offsetMs)。
如果实现中没有本地时间 t 的政治规则，结果就是 t，因为
21.4.1.26 UTC ( t )
抽象操作 UTC 接受参数 t（一个 Number）并返回一个
- 如果 t 不是
有限 的，返回NaN 。 - 设 systemTimeZoneIdentifier 为
SystemTimeZoneIdentifier ()。 - 如果
IsTimeZoneOffsetString (systemTimeZoneIdentifier) 是true ，那么- 设 offsetNs 为
ParseTimeZoneOffsetString (systemTimeZoneIdentifier)。
- 设 offsetNs 为
- 否则，
- 设 possibleInstants 为
GetNamedTimeZoneEpochNanoseconds (systemTimeZoneIdentifier,ℝ (YearFromTime (t)),ℝ (MonthFromTime (t)) + 1,ℝ (DateFromTime (t)),ℝ (HourFromTime (t)),ℝ (MinFromTime (t)),ℝ (SecFromTime (t)),ℝ (msFromTime (t)), 0, 0)。 - 注意：以下步骤确保当 t 表示在负时区转换时多次重复的本地时间（例如夏令时结束或由于时区规则变更导致时区偏移减少）或在正时区转换时跳过的本地时间（例如夏令时开始或由于时区规则变更导致时区偏移增加）时，t 使用转换前的时区偏移进行解释。
- 如果 possibleInstants 不为空，那么
- 设 disambiguatedInstant 为 possibleInstants[0]。
- 否则，
- 注意：t 表示在正时区转换时跳过的本地时间（例如由于夏令时开始或时区规则变更增加 UTC 偏移）。
- 设 possibleInstantsBefore 为
GetNamedTimeZoneEpochNanoseconds (systemTimeZoneIdentifier,ℝ (YearFromTime (tBefore)),ℝ (MonthFromTime (tBefore)) + 1,ℝ (DateFromTime (tBefore)),ℝ (HourFromTime (tBefore)),ℝ (MinFromTime (tBefore)),ℝ (SecFromTime (tBefore)),ℝ (msFromTime (tBefore)), 0, 0)，其中 tBefore 是小于 t 的最大整数 Number ，使得 possibleInstantsBefore 不为空（即，tBefore 表示转换前的最后一个本地时间）。 - 设 disambiguatedInstant 为 possibleInstantsBefore 的最后一个元素。
- 设 offsetNs 为
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier, disambiguatedInstant)。
- 设 possibleInstants 为
- 设 offsetMs 为
truncate (offsetNs / 106)。 - 返回 t -
𝔽 (offsetMs)。
输入 t 名义上是一个
如果实现中没有本地时间 t 的政治规则，结果就是 t，因为
2017 年 11 月 5 日在 America/New_York 的凌晨 1:30 重复了两次（回退），但必须解释为 1:30 AM UTC-04 而不是 1:30
AM UTC-05。
在 UTC(
2017 年 3 月 12 日在 America/New_York 的凌晨 2:30 不存在，但必须解释为 2:30 AM UTC-05（相当于 3:30 AM
UTC-04）。
在 UTC(
21.4.1.27 MakeTime ( hour, min, sec, ms )
抽象操作 MakeTime 接受参数 hour（一个 Number）、min（一个 Number）、sec（一个 Number）和 ms（一个 Number）并返回一个 Number。它 计算毫秒数。它在被调用时执行以下步骤：
- 如果 hour 不是
有限 的，min 不是有限 的， sec 不是有限 的，或 ms 不是有限 的，返回NaN 。 - 设 h 为
𝔽 (!ToIntegerOrInfinity (hour))。 - 设 m 为
𝔽 (!ToIntegerOrInfinity (min))。 - 设 s 为
𝔽 (!ToIntegerOrInfinity (sec))。 - 设 milli 为
𝔽 (!ToIntegerOrInfinity (ms))。 - 返回 ((h ×
msPerHour + m ×msPerMinute ) + s ×msPerSecond ) + milli。
MakeTime 中的算术是浮点算术，它不满足结合律，所以操作必须按正确的顺序执行。
21.4.1.28 MakeDay ( year, month, date )
抽象操作 MakeDay 接受参数 year（一个 Number）、month （一个 Number）和 date（一个 Number）并返回一个 Number。它计算天数。它在被调用时执行以下步骤：
- 如果 year 不是
有限 的，month 不是有限 的，或 date 不是有限 的，返回NaN 。 - 设 y 为
𝔽 (!ToIntegerOrInfinity (year))。 - 设 m 为
𝔽 (!ToIntegerOrInfinity (month))。 - 设 dt 为
𝔽 (!ToIntegerOrInfinity (date))。 - 设 ym 为 y +
𝔽 (floor (ℝ (m) / 12))。 - 如果 ym 不是
有限 的，返回NaN 。 - 设 mn 为
𝔽 (ℝ (m)modulo 12)。 - 找到一个
有限 的时间值 t，使得YearFromTime (t) 是 ym，MonthFromTime (t) 是 mn，并且DateFromTime (t) 是1 𝔽；但如果这不可能（因为某些 参数超出范围），返回NaN 。 - 返回
Day (t) + dt -1 𝔽。
21.4.1.29 MakeDate ( day, time )
抽象操作 MakeDate 接受参数 day（一个 Number）和 time （一个 Number）并返回一个 Number。它计算毫秒数。它在被调用时执行以下步骤：
21.4.1.30 MakeFullYear ( year )
抽象操作 MakeFullYear 接受参数 year（一个 Number）并返回一个
- 如果 year 是
NaN ，返回NaN 。 - 设 truncated 为 !
ToIntegerOrInfinity (year)。 - 如果 truncated 在
闭区间 0 到 99 中，返回1900 𝔽 +𝔽 (truncated)。 - 返回
𝔽 (truncated)。
21.4.1.31 TimeClip ( time )
抽象操作 TimeClip 接受参数 time（一个 Number）并返回一个 Number。它计算毫秒数。它在被调用时执行以下步骤：
- 如果 time 不是
有限 的，返回NaN 。 - 如果
abs (ℝ (time)) > 8.64 × 1015， 返回NaN 。 - 返回
𝔽 (!ToIntegerOrInfinity (time))。
21.4.1.32 日期时间字符串格式
ECMAScript 基于 ISO 8601 日历日期扩展格式的简化版本定义了日期时间的字符串交换格式。格式如下：
YYYY-MM-DDTHH:mm:ss.sssZ
其中各元素如下：
YYYY
|
是推算格里高利历中的年份，作为从 0000 到 9999 的四位十进制数字，或作为由 |
-
|
|
MM
|
是一年中的月份，作为从 01（一月）到 12（十二月）的两位十进制数字。 |
DD
|
是一个月中的日期，作为从 01 到 31 的两位十进制数字。 |
T
|
|
HH
|
是自午夜以来经过的完整小时数，作为从 00 到 24 的两位十进制数字。 |
:
|
|
mm
|
是自小时开始以来的完整分钟数，作为从 00 到 59 的两位十进制数字。 |
ss
|
是自分钟开始以来的完整秒数，作为从 00 到 59 的两位十进制数字。 |
.
|
|
sss
|
是自秒开始以来的完整毫秒数，作为三位十进制数字。 |
Z
|
是 UTC 偏移表示，指定为 HH:mm（ |
此格式包括仅日期形式：
YYYY
YYYY-MM
YYYY-MM-DD
它还包括"日期时间"形式，由上述仅日期形式之一紧接一个以下时间形式（可附加可选的 UTC 偏移表示）组成：
THH:mm
THH:mm:ss
THH:mm:ss.sss
包含超出边界或不符合要求元素的字符串不是此格式的有效实例。
由于每一天都以午夜开始和结束，00:00
和 24:00
这两种表示法可用于区分可能与一个日期关联的两个午夜。这意味着以下两种表示法指的是完全相同的时间点：1995-02-04T24:00 和
1995-02-05T00:00。将后一种形式解释为"日历日的结束"与 ISO 8601
一致，尽管该规范将其保留用于描述时间间隔，并且不允许在单个时间点的表示中使用。
不存在指定民用时区缩写（如 CET、EST 等）的国际标准，有时同一缩写甚至用于两个非常不同的时区。出于这个原因，ISO 8601 和此格式都指定时区偏移的数字表示。
21.4.1.32.1 扩展年份
涵盖从 1970 年 1 月 1 日向前或向后约 273,790 年的完整Date.parse
带有扩展年份的日期时间值示例：
| -271821-04-20T00:00:00Z | 公元前 271822 年 |
| -000001-01-01T00:00:00Z | 公元前 2 年 |
| +000000-01-01T00:00:00Z | 公元前 1 年 |
| +000001-01-01T00:00:00Z | 公元 1 年 |
| +001970-01-01T00:00:00Z | 公元 1970 年 |
| +002009-12-15T00:00:00Z | 公元 2009 年 |
| +275760-09-13T00:00:00Z | 公元 275760 年 |
21.4.1.33 时区偏移字符串格式
ECMAScript 定义了一个来源于 ISO 8601 的 UTC 偏移字符串交换格式。 该格式由以下语法描述。
语法
21.4.1.33.1 IsTimeZoneOffsetString ( offsetString )
抽象操作 IsTimeZoneOffsetString 接受参数 offsetString（一个
String）并返回一个 Boolean。返回值指示
offsetString 是否符合
21.4.1.33.2 ParseTimeZoneOffsetString ( offsetString )
抽象操作 ParseTimeZoneOffsetString 接受参数 offsetString
（一个 String）并返回一个
- 设 parseResult 为
ParseText (offsetString,UTCOffset )。 断言 ：parseResult 不是一个错误的列表 。断言 ：parseResult 包含一个ASCIISign 解析节点 。- 设 parsedSign 为 parseResult 中包含的
ASCIISign 解析节点 匹配的源文本 。 - 如果 parsedSign 是单个代码点 U+002D（连字符减号），那么
- 设 sign 为 -1。
- 否则，
- 设 sign 为 1。
- 注意：下面
StringToNumber 的应用不会丢失精度，因为每个解析值都保证是一个足够短的十进制数字字符串。 断言 ：parseResult 包含一个Hour 解析节点 。- 设 parsedHours 为 parseResult 中包含的
Hour 解析节点 匹配的源文本 。 - 设 hours 为
ℝ (StringToNumber (CodePointsToString (parsedHours)))。 - 如果 parseResult 不包含
MinuteSecond 解析节点 ，那么- 设 minutes 为 0。
- 否则，
- 设 parsedMinutes 为 parseResult 中包含的第一个
MinuteSecond 解析节点 匹配的源文本 。 - 设 minutes 为
ℝ (StringToNumber (CodePointsToString (parsedMinutes)))。
- 设 parsedMinutes 为 parseResult 中包含的第一个
- 如果 parseResult 不包含两个
MinuteSecond 解析节点 ，那么- 设 seconds 为 0。
- 否则，
- 设 parsedSeconds 为 parseResult 中包含的第二个
MinuteSecond 解析节点 匹配的源文本 。 - 设 seconds 为
ℝ (StringToNumber (CodePointsToString (parsedSeconds)))。
- 设 parsedSeconds 为 parseResult 中包含的第二个
- 如果 parseResult 不包含
TemporalDecimalFraction 解析节点 ，那么- 设 nanoseconds 为 0。
- 否则，
- 设 parsedFraction 为 parseResult 中包含的
TemporalDecimalFraction 解析节点 匹配的源文本 。 - 设 fraction 为
CodePointsToString (parsedFraction) 和"000000000" 的字符串连接 。 - 设 nanosecondsString 为 fraction 从 1 到 10 的
子字符串 。 - 设 nanoseconds 为
ℝ (StringToNumber (nanosecondsString))。
- 设 parsedFraction 为 parseResult 中包含的
- 返回 sign × (((hours × 60 + minutes) × 60 + seconds) × 109 + nanoseconds)。
21.4.2 Date 构造函数
Date
- 是 %Date%。
- 是
"Date" 属性在全局对象 上的初始值。 - 作为
构造函数 调用时，创建并初始化一个新的 Date。 - 作为函数而非
构造函数 调用时，返回一个表示当前时间（UTC）的字符串。 - 是一个其行为根据参数数量和类型而不同的函数。
- 可作为类定义中
extends子句的值使用。打算继承指定 Date 行为的子类构造函数 必须包含对 Date构造函数 的super调用，以使用 [[DateValue]] 内部槽创建并初始化子类实例。
21.4.2.1 Date ( ...values )
当调用此函数时，将执行以下步骤：
- 如果 NewTarget 为
undefined ，则- 令 now 为标识当前时间的
时间值 （UTC）。 - 返回
ToDateString (now)。
- 令 now 为标识当前时间的
- 令 numberOfArgs 为 values 中元素的数量。
- 如果 numberOfArgs = 0，则
- 令 dv 为标识当前时间的
时间值 （UTC）。
- 令 dv 为标识当前时间的
- 否则如果 numberOfArgs = 1，则
- 否则，
断言 ：numberOfArgs ≥ 2。- 令 y 为 ?
ToNumber (values[0])。 - 令 m 为 ?
ToNumber (values[1])。 - 如果 numberOfArgs > 2，令 dt 为 ?
ToNumber (values[2])；否则令 dt 为1 𝔽。 - 如果 numberOfArgs > 3，令 h 为 ?
ToNumber (values[3])；否则令 h 为+0 𝔽。 - 如果 numberOfArgs > 4，令 min 为 ?
ToNumber (values[4])；否则令 min 为+0 𝔽。 - 如果 numberOfArgs > 5，令 s 为 ?
ToNumber (values[5])；否则令 s 为+0 𝔽。 - 如果 numberOfArgs > 6，令 milli 为 ?
ToNumber (values[6])；否则令 milli 为+0 𝔽。 - 令 yr 为
MakeFullYear (y)。 - 令 finalDate 为
MakeDate (MakeDay (yr, m, dt),MakeTime (h, min, s, milli))。 - 令 dv 为
TimeClip (UTC (finalDate))。
- 令 O 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Date.prototype%" , « [[DateValue]] »)。 - 设置 O.[[DateValue]] 为 dv。
- 返回 O。
21.4.3 Date 构造函数的属性
Date
- 具有 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有值为
7 𝔽 的"length" 属性。 - 具有以下属性：
21.4.3.1 Date.now ( )
此函数返回表示调用时 UTC 日期和时间的
21.4.3.2 Date.parse ( string )
此函数对其参数应用
如果字符串符合 MM 或 DD 元素缺失时，使用 HH、mm 或 ss 元素缺失时，使用 sss 元素缺失时，使用
如果 x 是 ECMAScript 某一实现中毫秒数为零的 Date，则在该实现中，以下所有表达式（如果所有相关属性都是初始值）应产生相同的数值：
x.valueOf()
Date.parse(x.toString())
Date.parse(x.toUTCString())
Date.parse(x.toISOString())然而，下面的表达式
Date.parse(x.toLocaleString())不要求产生与前三个表达式相同的数值，并且通常当传入的字符串不符合日期时间字符串格式 (toString 或 toUTCString 方法在该实现中产生时，该函数的返回值是
21.4.3.3 Date.prototype
Date.prototype 的初始值是
该属性具有属性 { [[Writable]]:
21.4.3.4 Date.UTC ( year [ , month [ , date [ , hours [ , minutes [ , seconds [ , ms ] ] ] ] ] ] )
当调用此函数时，将执行以下步骤：
- 令 y 为 ?
ToNumber (year)。 - 如果 month 存在，令 m 为 ?
ToNumber (month)；否则，令 m 为+0 𝔽。 - 如果 date 存在，令 dt 为 ?
ToNumber (date)；否则，令 dt 为1 𝔽。 - 如果 hours 存在，令 h 为 ?
ToNumber (hours)；否则，令 h 为+0 𝔽。 - 如果 minutes 存在，令 min 为 ?
ToNumber (minutes)；否则，令 min 为+0 𝔽。 - 如果 seconds 存在，令 s 为 ?
ToNumber (seconds)；否则，令 s 为+0 𝔽。 - 如果 ms 存在，令 milli 为 ?
ToNumber (ms)；否则，令 milli 为+0 𝔽。 - 令 yr 为
MakeFullYear (y)。 - 返回
TimeClip (MakeDate (MakeDay (yr, m, dt),MakeTime (h, min, s, milli)))。
该函数的
21.4.4 Date 原型对象的属性
Date 原型对象：
- 是 %Date.prototype%。
- 它本身是一个
普通对象 。 - 不是 Date 实例，也没有 [[DateValue]] 内部槽。
- 具有 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
除非另有明确规定，下文定义的 Date 原型对象的方法不是泛型的，传递给它们的
21.4.4.1 Date.prototype.constructor
Date.prototype.constructor 的初始值是
21.4.4.2 Date.prototype.getDate ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
DateFromTime (LocalTime (t))。
21.4.4.3 Date.prototype.getDay ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
WeekDay (LocalTime (t))。
21.4.4.4 Date.prototype.getFullYear ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
YearFromTime (LocalTime (t))。
21.4.4.5 Date.prototype.getHours ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
HourFromTime (LocalTime (t))。
21.4.4.6 Date.prototype.getMilliseconds ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
msFromTime (LocalTime (t))。
21.4.4.7 Date.prototype.getMinutes ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
MinFromTime (LocalTime (t))。
21.4.4.8 Date.prototype.getMonth ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
MonthFromTime (LocalTime (t))。
21.4.4.9 Date.prototype.getSeconds ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
SecFromTime (LocalTime (t))。
21.4.4.10 Date.prototype.getTime ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 返回 dateObject.[[DateValue]]。
21.4.4.11 Date.prototype.getTimezoneOffset ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回 (t -
LocalTime (t)) /msPerMinute 。
21.4.4.12 Date.prototype.getUTCDate ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
DateFromTime (t)。
21.4.4.13 Date.prototype.getUTCDay ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
WeekDay (t)。
21.4.4.14 Date.prototype.getUTCFullYear ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
YearFromTime (t)。
21.4.4.15 Date.prototype.getUTCHours ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
HourFromTime (t)。
21.4.4.16 Date.prototype.getUTCMilliseconds ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
msFromTime (t)。
21.4.4.17 Date.prototype.getUTCMinutes ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
MinFromTime (t)。
21.4.4.18 Date.prototype.getUTCMonth ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
MonthFromTime (t)。
21.4.4.19 Date.prototype.getUTCSeconds ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则返回NaN 。 - 返回
SecFromTime (t)。
21.4.4.20 Date.prototype.setDate ( date )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 dt 为 ?
ToNumber (date)。 - 如果 t 为
NaN ，则返回NaN 。 - 设置 t 为
LocalTime (t)。 - 令 newDate 为
MakeDate (MakeDay (YearFromTime (t),MonthFromTime (t), dt),TimeWithinDay (t))。 - 令 u 为
TimeClip (UTC (newDate))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
21.4.4.21 Date.prototype.setFullYear ( year [ , month [ , date ] ] )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 y 为 ?
ToNumber (year)。 - 如果 t 为
NaN ，则设置 t 为+0 𝔽；否则，设置 t 为LocalTime (t)。 - 如果 month 未给出，令 m 为
MonthFromTime (t)；否则，令 m 为 ?ToNumber (month)。 - 如果 date 未给出，令 dt 为
DateFromTime (t)；否则，令 dt 为 ?ToNumber (date)。 - 令 newDate 为
MakeDate (MakeDay (y, m, dt),TimeWithinDay (t))。 - 令 u 为
TimeClip (UTC (newDate))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
该方法的
如果未给出 month，本方法表现为 month 的值为 getMonth()。如果未给出
date，则表现为 date 的值为 getDate()。
21.4.4.22 Date.prototype.setHours ( hour [ , min [ , sec [ , ms ] ] ] )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 h 为 ?
ToNumber (hour)。 - 如果 min 给出，令 m 为 ?
ToNumber (min)。 - 如果 sec 给出，令 s 为 ?
ToNumber (sec)。 - 如果 ms 给出，令 milli 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，则返回NaN 。 - 设置 t 为
LocalTime (t)。 - 如果 min 未给出，令 m 为
MinFromTime (t)。 - 如果 sec 未给出，令 s 为
SecFromTime (t)。 - 如果 ms 未给出，令 milli 为
msFromTime (t)。 - 令 date 为
MakeDate (Day (t),MakeTime (h, m, s, milli))。 - 令 u 为
TimeClip (UTC (date))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
该方法的
如果未给出 min，本方法表现为 min 的值为 getMinutes()。如果未给出
sec，则表现为 sec 的值为 getSeconds()。如果未给出
ms，则表现为 ms 的值为 getMilliseconds()。
21.4.4.23 Date.prototype.setMilliseconds ( ms )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 将 ms 设为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 将 t 设为
LocalTime (t)。 - 令 time 为
MakeTime (HourFromTime (t),MinFromTime (t),SecFromTime (t), ms)。 - 令 u 为
TimeClip (UTC (MakeDate (Day (t), time)))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
21.4.4.24 Date.prototype.setMinutes ( min [ , sec [ , ms ] ] )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 m 为 ?
ToNumber (min)。 - 如果 sec 给出，令 s 为 ?
ToNumber (sec)。 - 如果 ms 给出，令 milli 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 设置 t 为
LocalTime (t)。 - 如果 sec 未给出，令 s 为
SecFromTime (t)。 - 如果 ms 未给出，令 milli 为
msFromTime (t)。 - 令 date 为
MakeDate (Day (t),MakeTime (HourFromTime (t), m, s, milli))。 - 令 u 为
TimeClip (UTC (date))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
该方法的
如果未给出 sec，本方法表现为 sec 的值为 getSeconds()。如果未给出
ms，则表现为 ms 的值为 getMilliseconds()。
21.4.4.25 Date.prototype.setMonth ( month [ , date ] )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 m 为 ?
ToNumber (month)。 - 如果 date 给出，令 dt 为 ?
ToNumber (date)。 - 如果 t 为
NaN ，返回NaN 。 - 设置 t 为
LocalTime (t)。 - 如果 date 未给出，令 dt 为
DateFromTime (t)。 - 令 newDate 为
MakeDate (MakeDay (YearFromTime (t), m, dt),TimeWithinDay (t))。 - 令 u 为
TimeClip (UTC (newDate))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
该方法的
如果未给出 date，本方法表现为 date 的值为 getDate()。
21.4.4.26 Date.prototype.setSeconds ( sec [ , ms ] )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 s 为 ?
ToNumber (sec)。 - 如果 ms 给出，令 milli 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 设置 t 为
LocalTime (t)。 - 如果 ms 未给出，令 milli 为
msFromTime (t)。 - 令 date 为
MakeDate (Day (t),MakeTime (HourFromTime (t),MinFromTime (t), s, milli))。 - 令 u 为
TimeClip (UTC (date))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
该方法的
如果未给出 ms，本方法表现为 ms 的值为 getMilliseconds()。
21.4.4.27 Date.prototype.setTime ( time )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 ?
ToNumber (time)。 - 令 v 为
TimeClip (t)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
21.4.4.28 Date.prototype.setUTCDate ( date )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 dt 为 ?
ToNumber (date)。 - 如果 t 为
NaN ，返回NaN 。 - 令 newDate 为
MakeDate (MakeDay (YearFromTime (t),MonthFromTime (t), dt),TimeWithinDay (t))。 - 令 v 为
TimeClip (newDate)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
21.4.4.29 Date.prototype.setUTCFullYear ( year [ , month [ , date ] ] )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，则设置 t 为+0 𝔽。 - 令 y 为 ?
ToNumber (year)。 - 如果 month 未给出，令 m 为
MonthFromTime (t)； 否则，令 m 为 ?ToNumber (month)。 - 如果 date 未给出，令 dt 为
DateFromTime (t)； 否则，令 dt 为 ?ToNumber (date)。 - 令 newDate 为
MakeDate (MakeDay (y, m, dt),TimeWithinDay (t))。 - 令 v 为
TimeClip (newDate)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
该方法的
如果未给出 month，本方法表现为 month 的值为 getUTCMonth()。如果未给出
date，则表现为 date 的值为 getUTCDate()。
21.4.4.30 Date.prototype.setUTCHours ( hour [ , min [ , sec [ , ms ] ] ] )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 h 为 ?
ToNumber (hour)。 - 如果 min 给出，令 m 为 ?
ToNumber (min)。 - 如果 sec 给出，令 s 为 ?
ToNumber (sec)。 - 如果 ms 给出，令 milli 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 如果 min 未给出，令 m 为
MinFromTime (t)。 - 如果 sec 未给出，令 s 为
SecFromTime (t)。 - 如果 ms 未给出，令 milli 为
msFromTime (t)。 - 令 date 为
MakeDate (Day (t),MakeTime (h, m, s, milli))。 - 令 v 为
TimeClip (date)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
该方法的
如果未给出 min，本方法表现为 min 的值为 getUTCMinutes()。如果未给出
sec，则表现为 sec 的值为 getUTCSeconds()。如果未给出
ms，则表现为 ms 的值为 getUTCMilliseconds()。
21.4.4.31 Date.prototype.setUTCMilliseconds ( ms )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 将 ms 设为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 令 time 为
MakeTime (HourFromTime (t),MinFromTime (t),SecFromTime (t), ms)。 - 令 v 为
TimeClip (MakeDate (Day (t), time))。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
21.4.4.32 Date.prototype.setUTCMinutes ( min [ , sec [ , ms ] ] )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 m 为 ?
ToNumber (min)。 - 如果 sec 给出，令 s 为 ?
ToNumber (sec)。 - 如果 ms 给出，令 milli 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 如果 sec 未给出，令 s 为
SecFromTime (t)。 - 如果 ms 未给出，令 milli 为
msFromTime (t)。 - 令 date 为
MakeDate (Day (t),MakeTime (HourFromTime (t), m, s, milli))。 - 令 v 为
TimeClip (date)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
该方法的
如果未给出 sec，本方法表现为 sec 的值为 getUTCSeconds()。如果未给出
ms，则表现为 ms 的值为 getUTCMilliseconds()。
21.4.4.33 Date.prototype.setUTCMonth ( month [ , date ] )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 m 为 ?
ToNumber (month)。 - 如果 date 给出，令 dt 为 ?
ToNumber (date)。 - 如果 t 为
NaN ，返回NaN 。 - 如果 date 未给出，令 dt 为
DateFromTime (t)。 - 令 newDate 为
MakeDate (MakeDay (YearFromTime (t), m, dt),TimeWithinDay (t))。 - 令 v 为
TimeClip (newDate)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
该方法的
如果未给出 date，本方法表现为 date 的值为 getUTCDate()。
21.4.4.34 Date.prototype.setUTCSeconds ( sec [ , ms ] )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 s 为 ?
ToNumber (sec)。 - 如果 ms 给出，令 milli 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 如果 ms 未给出，令 milli 为
msFromTime (t)。 - 令 date 为
MakeDate (Day (t),MakeTime (HourFromTime (t),MinFromTime (t), s, milli))。 - 令 v 为
TimeClip (date)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
该方法的
如果未给出 ms，本方法表现为 ms 的值为 getUTCMilliseconds()。
21.4.4.35 Date.prototype.toDateString ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 tv 为 dateObject.[[DateValue]]。
- 如果 tv 为
NaN ，返回"Invalid Date" 。 - 令 t 为
LocalTime (tv)。 - 返回
DateString (t)。
21.4.4.36 Date.prototype.toISOString ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 tv 为 dateObject.[[DateValue]]。
- 如果 tv 为
NaN ，抛出RangeError 异常。 断言 ：tv 是一个整数 Number 。- 如果 tv 所对应的年份不能用
日期时间字符串格式 表示，则抛出RangeError 异常。 - 返回 tv 在 UTC 时标下、
日期时间字符串格式 的字符串表示，包括所有格式元素及 UTC 偏移 "Z"。
21.4.4.37 Date.prototype.toJSON ( key )
此方法为 JSON.stringify (
调用该方法时，执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 tv 为 ?
ToPrimitive (O,number )。 - 如果 tv
是 Number 且 tv 不是有限值 ，则返回null 。 - 返回 ?
Invoke (O,"toISOString" )。
参数会被忽略。
此方法有意设计为泛型；它不要求其 toISOString 方法。
21.4.4.38 Date.prototype.toLocaleDateString ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按照 ECMA-402 规范实现此方法。如果 ECMAScript 实现未包含 ECMA-402 API，则使用以下规范：
该方法返回一个字符串值。字符串内容是
本方法的可选参数含义在 ECMA-402 规范中定义；未包含 ECMA-402 支持的实现不得将这些参数位置用于其他用途。
21.4.4.39 Date.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按照 ECMA-402 规范实现此方法。如果 ECMAScript 实现未包含 ECMA-402 API，则使用以下规范：
该方法返回一个字符串值。字符串内容是
本方法的可选参数含义在 ECMA-402 规范中定义；未包含 ECMA-402 支持的实现不得将这些参数位置用于其他用途。
21.4.4.40 Date.prototype.toLocaleTimeString ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按照 ECMA-402 规范实现此方法。如果 ECMAScript 实现未包含 ECMA-402 API，则使用以下规范：
该方法返回一个字符串值。字符串内容是
本方法的可选参数含义在 ECMA-402 规范中定义；未包含 ECMA-402 支持的实现不得将这些参数位置用于其他用途。
21.4.4.41 Date.prototype.toString ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 tv 为 dateObject.[[DateValue]]。
- 返回
ToDateString (tv)。
对于任何 Date d，如果 d.[[DateValue]] 能被
1000 整除，则 Date.parse(d.toString()) 的结果等于
d.valueOf()。参见
此方法不是泛型；如果其
21.4.4.41.1 TimeString ( tv )
抽象操作 TimeString 接受参数 tv（Number，但不是
- 令 hour 为
ToZeroPaddedDecimalString (ℝ (HourFromTime (tv)), 2)。 - 令 minute 为
ToZeroPaddedDecimalString (ℝ (MinFromTime (tv)), 2)。 - 令 second 为
ToZeroPaddedDecimalString (ℝ (SecFromTime (tv)), 2)。 - 返回
字符串拼接 hour、":" 、minute、":" 、second、0x0020（空格）、"GMT" 。
21.4.4.41.2 DateString ( tv )
抽象操作 DateString 接受参数 tv（Number，但不是
- 令 weekday 为
表 65 中编号为WeekDay (tv) 的 Name。 - 令 month 为
表 66 中编号为MonthFromTime (tv) 的 Name。 - 令 day 为
ToZeroPaddedDecimalString (ℝ (DateFromTime (tv)), 2)。 - 令 yv 为
YearFromTime (tv)。 - 如果 yv 是
+0 𝔽 或 yv >+0 𝔽，则 yearSign 为空字符串；否则 yearSign 为"-" 。 - 令 paddedYear 为
ToZeroPaddedDecimalString (abs (ℝ (yv)), 4)。 - 返回
字符串拼接 weekday、0x0020（空格）、month、0x0020、day、0x0020、yearSign 和 paddedYear。
| 编号 | 名称 |
|---|---|
| 编号 | 名称 |
|---|---|
21.4.4.41.3 TimeZoneString ( tv )
抽象操作 TimeZoneString 接受参数 tv（
- 令 systemTimeZoneIdentifier 为
SystemTimeZoneIdentifier ()。 - 如果
IsTimeZoneOffsetString (systemTimeZoneIdentifier) 为true ，则- 令 offsetNs 为
ParseTimeZoneOffsetString (systemTimeZoneIdentifier)。
- 令 offsetNs 为
- 否则，
- 令 offsetNs 为
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier,ℤ (ℝ (tv) × 106))。
- 令 offsetNs 为
- 令 offset 为
𝔽 (truncate (offsetNs / 106))。 - 如果 offset 为
+0 𝔽 或 offset >+0 𝔽，则- 令 offsetSign 为
"+" 。 - 令 absOffset 为 offset。
- 令 offsetSign 为
- 否则，
- 令 offsetSign 为
"-" 。 - 令 absOffset 为 -offset。
- 令 offsetSign 为
- 令 offsetMin 为
ToZeroPaddedDecimalString (ℝ (MinFromTime (absOffset)), 2)。 - 令 offsetHour 为
ToZeroPaddedDecimalString (ℝ (HourFromTime (absOffset)), 2)。 - 令 tzName 为一个
实现定义 的字符串，其值可以为空字符串，也可以是 0x0020（空格）、0x0028（左括号）、实现定义 的时区名称和 0x0029（右括号）的字符串拼接。 - 返回
字符串拼接 offsetSign、offsetHour、offsetMin 和 tzName。
21.4.4.41.4 ToDateString ( tv )
抽象操作 ToDateString 接受参数 tv（
- 如果 tv 为
NaN ，返回"Invalid Date" 。 - 令 t 为
LocalTime (tv)。 - 返回
字符串拼接 DateString (t)、0x0020（空格）、TimeString (t) 和TimeZoneString (tv)。
21.4.4.42 Date.prototype.toTimeString ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 tv 为 dateObject.[[DateValue]]。
- 如果 tv 为
NaN ，返回"Invalid Date" 。 - 令 t 为
LocalTime (tv)。 - 返回
字符串拼接 TimeString (t) 和TimeZoneString (tv)。
21.4.4.43 Date.prototype.toUTCString ( )
该方法返回一个字符串值，表示与
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 tv 为 dateObject.[[DateValue]]。
- 如果 tv 为
NaN ，返回"Invalid Date" 。 - 令 weekday 为
表 65 中编号为WeekDay (tv) 的 Name。 - 令 month 为
表 66 中编号为MonthFromTime (tv) 的 Name。 - 令 day 为
ToZeroPaddedDecimalString (ℝ (DateFromTime (tv)), 2)。 - 令 yv 为
YearFromTime (tv)。 - 如果 yv 是
+0 𝔽 或 yv >+0 𝔽，则 yearSign 为空字符串；否则 yearSign 为"-" 。 - 令 paddedYear 为
ToZeroPaddedDecimalString (abs (ℝ (yv)), 4)。 - 返回
字符串拼接 weekday、"," 、0x0020（空格）、day、0x0020、month、0x0020、yearSign、paddedYear、0x0020 和TimeString (tv)。
21.4.4.44 Date.prototype.valueOf ( )
调用该方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 返回 dateObject.[[DateValue]]。
21.4.4.45 Date.prototype [ %Symbol.toPrimitive% ] ( hint )
此方法被 ECMAScript 语言运算符调用，用于将 Date 转换为原始值。hint 的允许值为
调用该方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O
不是对象 ，则抛出TypeError 异常。 - 如果 hint 是
"string" 或"default" ，则- 令 tryFirst 为
string 。
- 令 tryFirst 为
- 否则如果 hint 是
"number" ，则- 令 tryFirst 为
number 。
- 令 tryFirst 为
- 否则，
- 抛出
TypeError 异常。
- 抛出
- 返回 ?
OrdinaryToPrimitive (O, tryFirst)。
该属性具有属性 { [[Writable]]:
本方法的
21.4.5 Date 实例的属性
Date 实例是
22 文本处理
22.1 字符串对象
22.1.1 String 构造函数
String
- 是 %String%。
- 是
"String" 属性在全局对象 上的初始值。 - 作为
构造函数 调用时，创建并初始化一个新的 String 对象。 - 作为函数调用而非
构造函数 时，执行类型转换。 - 可作为类定义中
extends子句的值使用。打算继承指定 String 行为的子类构造函数 必须包含对 String构造函数 的super调用，以用 [[StringData]] 内部槽创建并初始化子类实例。
22.1.1.1 String ( value )
当调用该函数时，执行以下步骤：
- 如果 value 未给出，则
- 令 s 为空字符串。
- 否则，
- 如果 NewTarget 为
undefined 且 value是 Symbol ，则返回SymbolDescriptiveString (value)。 - 令 s 为 ?
ToString (value)。
- 如果 NewTarget 为
- 如果 NewTarget 为
undefined ，返回 s。 - 返回
StringCreate (s, ?GetPrototypeFromConstructor (NewTarget,"%String.prototype%" ))。
22.1.2 String 构造函数的属性
String
- 具有 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
22.1.2.1 String.fromCharCode ( ...codeUnits )
该函数可以接收任意数量的参数，这些参数形成余参数 codeUnits。
调用该函数时，执行以下步骤：
该函数的
22.1.2.2 String.fromCodePoint ( ...codePoints )
该函数可以接收任意数量的参数，这些参数形成余参数 codePoints。
调用该函数时，执行以下步骤：
该函数的
22.1.2.3 String.prototype
String.prototype 的初始值为
该属性具有属性 { [[Writable]]:
22.1.2.4 String.raw ( template, ...substitutions )
该函数可以接收可变数量的参数。第一个参数为 template，其余参数组成
调用该函数时，执行以下步骤：
- 令 substitutionCount 为 substitutions 的元素个数。
- 令 cooked 为 ?
ToObject (template)。 - 令 literals 为 ?
ToObject (?Get (cooked,"raw" ))。 - 令 literalCount 为 ?
LengthOfArrayLike (literals)。 - 如果 literalCount ≤ 0，返回空字符串。
- 令 R 为空字符串。
- 令 nextIndex 为 0。
- 重复，
该函数用于作为标记模板（Tagged Template）（
22.1.3 String 原型对象的属性
String 原型对象：
- 是 %String.prototype%。
是 String 特殊对象 ，并拥有为此类对象规定的内部方法。- 有一个 [[StringData]] 内部槽，其值为空字符串。
- 有一个
"length" 属性，其初始值为+0 𝔽，属性为 { [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false }。 - 有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
除非另有明确声明，下文定义的 String 原型对象的方法都不是泛型方法，传递给它们的
22.1.3.1 String.prototype.at ( index )
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 len 为 S 的长度。
- 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 如果 relativeIndex ≥ 0，则
- 令 k 为 relativeIndex。
- 否则，
- 令 k 为 len + relativeIndex。
- 如果 k < 0 或 k ≥ len，返回
undefined 。 - 返回
substring S 从 k 到 k + 1。
22.1.3.2 String.prototype.charAt ( pos )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 position 为 ?
ToIntegerOrInfinity (pos)。 - 令 size 为 S 的长度。
- 如果 position < 0 或 position ≥ size，返回空字符串。
- 返回
substring S 从 position 到 position + 1。
此方法有意设计为泛型；它不要求其
22.1.3.3 String.prototype.charCodeAt ( pos )
此方法返回一个 Number（一个非负的
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 position 为 ?
ToIntegerOrInfinity (pos)。 - 令 size 为 S 的长度。
- 如果 position < 0 或 position ≥ size，返回
NaN 。 - 返回
Number value for 字符串 S 中索引为 position 的码元的数值。
此方法有意设计为泛型；它不要求其
22.1.3.4 String.prototype.codePointAt ( pos )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 position 为 ?
ToIntegerOrInfinity (pos)。 - 令 size 为 S 的长度。
- 如果 position < 0 或 position ≥ size，返回
undefined 。 - 令 cp 为
CodePointAt (S, position)。 - 返回
𝔽 (cp.[[CodePoint]])。
此方法有意设计为泛型；它不要求其
22.1.3.5 String.prototype.concat ( ...args )
调用此方法时，返回由
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 R 为 S。
- 对于 args 中的每个元素 next，执行
- 返回 R。
该方法的
此方法有意设计为泛型；它不要求其
22.1.3.6 String.prototype.constructor
String.prototype.constructor 的初始值为
22.1.3.7 String.prototype.endsWith ( searchString [ , endPosition ] )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 isRegExp 为 ?
IsRegExp (searchString)。 - 如果 isRegExp 为
true ，抛出TypeError 异常。 - 令 searchStr 为 ?
ToString (searchString)。 - 令 len 为 S 的长度。
- 如果 endPosition 为
undefined ，令 pos 为 len；否则令 pos 为 ?ToIntegerOrInfinity (endPosition)。 - 令 end 为
clamping pos 介于 0 和 len 之间的结果。 - 令 searchLength 为 searchStr 的长度。
- 如果 searchLength = 0，返回
true 。 - 令 start 为 end - searchLength。
- 如果 start < 0，返回
false 。 - 令 substring 为
substring S 从 start 到 end。 - 如果 substring 等于 searchStr，返回
true 。 - 返回
false 。
如果 searchString（转换为 String）码元序列与本对象（转换为 String）中从 endPosition -
length(this) 开始的对应码元相同，则该方法返回
如果第一个参数是 RegExp 抛出异常，是为了允许后续标准版本定义支持此类参数值的扩展。
此方法有意设计为泛型；它不要求其
22.1.3.8 String.prototype.includes ( searchString [ , position ] )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 isRegExp 为 ?
IsRegExp (searchString)。 - 如果 isRegExp 为
true ，抛出TypeError 异常。 - 令 searchStr 为 ?
ToString (searchString)。 - 令 pos 为 ?
ToIntegerOrInfinity (position)。 断言 ：如果 position 为undefined ，则 pos 为 0。- 令 len 为 S 的长度。
- 令 start 为
clamping pos 介于 0 和 len 之间的结果。 - 令 index 为
StringIndexOf (S, searchStr, start)。 - 如果 index 为
not-found ，返回false 。 - 返回
true 。
如果 searchString 作为
如果第一个参数是 RegExp 抛出异常，是为了允许后续标准版本定义支持此类参数值的扩展。
此方法有意设计为泛型；它不要求其
22.1.3.9 String.prototype.indexOf ( searchString [ , position ] )
如果 searchString 作为
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 searchStr 为 ?
ToString (searchString)。 - 令 pos 为 ?
ToIntegerOrInfinity (position)。 断言 ：如果 position 为undefined ，则 pos 为 0。- 令 len 为 S 的长度。
- 令 start 为
clamping pos 介于 0 和 len 之间的结果。 - 令 result 为
StringIndexOf (S, searchStr, start)。 - 如果 result 为
not-found ，返回-1 𝔽。 - 返回
𝔽 (result)。
此方法有意设计为泛型；它不要求其
22.1.3.10 String.prototype.isWellFormed ( )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 返回
IsStringWellFormedUnicode (S)。
22.1.3.11 String.prototype.lastIndexOf ( searchString [ , position ] )
如果 searchString 作为
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 searchStr 为 ?
ToString (searchString)。 - 令 numPos 为 ?
ToNumber (position)。 断言 ：如果 position 为undefined ，则 numPos 为NaN 。- 如果 numPos 为
NaN ，令 pos 为 +∞；否则，令 pos 为 !ToIntegerOrInfinity (numPos)。 - 令 len 为 S 的长度。
- 令 searchLen 为 searchStr 的长度。
- 令 start 为
clamping pos 介于 0 和 len - searchLen 之间的结果。 - 令 result 为
StringLastIndexOf (S, searchStr, start)。 - 如果 result 为
not-found ，返回-1 𝔽。 - 返回
𝔽 (result)。
此方法有意设计为泛型；它不要求其
22.1.3.12 String.prototype.localeCompare ( that [ , reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按照 ECMA-402 规范实现此方法。如果 ECMAScript 实现未包含 ECMA-402 API，则使用以下规范：
该方法返回一个除
在执行比较前，该方法会按如下步骤准备字符串：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 thatValue 为 ?
ToString (that)。
本方法的第二和第三个可选参数的含义在 ECMA-402 规范中定义；未包含 ECMA-402 支持的实现不得将这些参数位置用于其他用途。
实际返回值为
此方法本身不适合作为 Array.prototype.sort 的参数，因为后者需要两个参数的函数。
此方法可依赖 ECMAScript 环境从
// Å ANGSTROM SIGN vs.
// Å LATIN CAPITAL LETTER A + COMBINING RING ABOVE
"\u212B".localeCompare("A\u030A")
// Ω OHM SIGN vs.
// Ω GREEK CAPITAL LETTER OMEGA
"\u2126".localeCompare("\u03A9")
// ṩ LATIN SMALL LETTER S WITH DOT BELOW AND DOT ABOVE vs.
// ṩ LATIN SMALL LETTER S + COMBINING DOT ABOVE + COMBINING DOT BELOW
"\u1E69".localeCompare("s\u0307\u0323")
// ḍ̇ LATIN SMALL LETTER D WITH DOT ABOVE + COMBINING DOT BELOW vs.
// ḍ̇ LATIN SMALL LETTER D WITH DOT BELOW + COMBINING DOT ABOVE
"\u1E0B\u0323".localeCompare("\u1E0D\u0307")
// 가 HANGUL CHOSEONG KIYEOK + HANGUL JUNGSEONG A vs.
// 가 HANGUL SYLLABLE GA
"\u1100\u1161".localeCompare("\uAC00")关于规范等价的定义和讨论，参见 Unicode 标准第 2 章和第 3 章，以及 Unicode Standard Annex #15, Unicode Normalization Forms 和 Unicode Technical Note #5, Canonical Equivalence in Applications。另见 Unicode Technical Standard #10, Unicode Collation Algorithm。
建议本方法不应遵循 Unicode 兼容等价或 Unicode 标准第 3 章第 3.7 节定义的兼容分解。
此方法有意设计为泛型；它不要求其
22.1.3.13 String.prototype.match ( regexp )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 如果 regexp 既不是
undefined 也不是null ，则- 令 matcher 为 ?
GetMethod (regexp,%Symbol.match% )。 - 如果 matcher 不为
undefined ，则- 返回 ?
Call (matcher, regexp, « O »)。
- 返回 ?
- 令 matcher 为 ?
- 令 S 为 ?
ToString (O)。 - 令 rx 为 ?
RegExpCreate (regexp,undefined )。 - 返回 ?
Invoke (rx,%Symbol.match% , « S »)。
此方法有意设计为泛型；它不要求其
22.1.3.14 String.prototype.matchAll ( regexp )
该方法对将
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 如果 regexp 既不是
undefined 也不是null ，则- 令 isRegExp 为 ?
IsRegExp (regexp)。 - 如果 isRegExp 为
true ，则- 令 flags 为 ?
Get (regexp,"flags" )。 - 执行 ?
RequireObjectCoercible (flags)。 - 如果 ?
ToString (flags) 不包含"g" ，抛出TypeError 异常。
- 令 flags 为 ?
- 令 matcher 为 ?
GetMethod (regexp,%Symbol.matchAll% )。 - 如果 matcher 不为
undefined ，则- 返回 ?
Call (matcher, regexp, « O »)。
- 返回 ?
- 令 isRegExp 为 ?
- 令 S 为 ?
ToString (O)。 - 令 rx 为 ?
RegExpCreate (regexp,"g" )。 - 返回 ?
Invoke (rx,%Symbol.matchAll% , « S »)。
String.prototype.split
类似，String.prototype.matchAll 通常不应改变其输入。22.1.3.15 String.prototype.normalize ( [ form ] )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 如果 form 为
undefined ，令 f 为"NFC" 。 - 否则，令 f 为 ?
ToString (form)。 - 如果 f 不是
"NFC" 、"NFD" 、"NFKC" 或"NFKD" 之一，则抛出RangeError 异常。 - 令 ns 为将 S 按 最新 Unicode 标准，Normalization Forms 中由 f 命名的规范形式规范化后的字符串值。
- 返回 ns。
此方法有意设计为泛型，不要求其
22.1.3.16 String.prototype.padEnd ( maxLength [ , fillString ] )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 返回 ?
StringPaddingBuiltinsImpl (O, maxLength, fillString,end )。
22.1.3.17 String.prototype.padStart ( maxLength [ , fillString ] )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 返回 ?
StringPaddingBuiltinsImpl (O, maxLength, fillString,start )。
22.1.3.17.1 StringPaddingBuiltinsImpl ( O, maxLength, fillString, placement )
抽象操作 StringPaddingBuiltinsImpl 接收参数 O（
22.1.3.17.2 StringPad ( S, maxLength, fillString, placement )
抽象操作 StringPad 接收参数 S（字符串）、maxLength（非负
maxLength 参数会被限制，不能小于 S 的长度。
fillString 参数的默认值为
22.1.3.17.3 ToZeroPaddedDecimalString ( n, minLength )
抽象操作 ToZeroPaddedDecimalString 接收参数 n（非负
- 令 S 为 n 的字符串表示，格式为十进制数。
- 返回
StringPad (S, minLength,"0" ,start )。
22.1.3.18 String.prototype.repeat ( count )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 n 为 ?
ToIntegerOrInfinity (count)。 - 如果 n < 0 或 n = +∞，抛出
RangeError 异常。 - 如果 n = 0，返回空字符串。
- 返回由 S 拼接 n 次组成的字符串值。
此方法会创建由
此方法有意设计为泛型；它不要求其
22.1.3.19 String.prototype.replace ( searchValue, replaceValue )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 如果 searchValue 既不是
undefined 也不是null ，则- 令 replacer 为 ?
GetMethod (searchValue,%Symbol.replace% )。 - 如果 replacer 不为
undefined ，则- 返回 ?
Call (replacer, searchValue, « O, replaceValue »)。
- 返回 ?
- 令 replacer 为 ?
- 令 string 为 ?
ToString (O)。 - 令 searchString 为 ?
ToString (searchValue)。 - 令 functionalReplace 为
IsCallable (replaceValue)。 - 如果 functionalReplace 为
false ，则- 将 replaceValue 设为 ?
ToString (replaceValue)。
- 将 replaceValue 设为 ?
- 令 searchLength 为 searchString 的长度。
- 令 position 为
StringIndexOf (string, searchString, 0)。 - 如果 position 为
not-found ，返回 string。 - 令 preceding 为
substring string 从 0 到 position。 - 令 following 为
substring string 从 position + searchLength。 - 如果 functionalReplace 为
true ，则 - 否则，
断言 ：replaceValue是 String 。- 令 captures 为新的空
List 。 - 令 replacement 为 !
GetSubstitution (searchString, string, position, captures,undefined , replaceValue)。
- 返回
字符串拼接 preceding、replacement 和 following。
此方法有意设计为泛型；它不要求其
22.1.3.19.1 GetSubstitution ( matched, str, position, captures, namedCaptures, replacementTemplate )
抽象操作 GetSubstitution 接收参数
matched（字符串）、str（字符串）、position（非负
- 令 stringLength 为 str 的长度。
断言 ：position ≤ stringLength。- 令 result 为空字符串。
- 令 templateRemainder 为 replacementTemplate。
- 重复，直到 templateRemainder 为空字符串，
- 注：以下步骤隔离 ref（templateRemainder 的前缀），确定 refReplacement（其替换内容），然后将该替换内容追加到 result。
- 如果 templateRemainder 以
"$$" 开头，则- 令 ref 为
"$$" 。 - 令 refReplacement 为
"$" 。
- 令 ref 为
- 否则，如果 templateRemainder 以
"$`" 开头，则- 令 ref 为
"$`" 。 - 令 refReplacement 为
substring str 从 0 到 position。
- 令 ref 为
- 否则，如果 templateRemainder 以
"$&" 开头，则- 令 ref 为
"$&" 。 - 令 refReplacement 为 matched。
- 令 ref 为
- 否则，如果 templateRemainder 以
"$'" （0x0024（美元符号）后接 0x0027（撇号））开头，则- 令 ref 为
"$'" 。 - 令 matchLength 为 matched 的长度。
- 令 tailPos 为 position + matchLength。
- 令 refReplacement 为
substring str 从min (tailPos, stringLength)。 - 注：tailPos 只有在该抽象操作由对 %RegExp.prototype% 的
%Symbol.replace% 内置方法调用，且对象的"exec" 属性不是内置 %RegExp.prototype.exec% 时才会超过 stringLength。
- 令 ref 为
- 否则，如果 templateRemainder 以
"$" 后跟 1 个或多个十进制数字开头，则- 如果 templateRemainder 以
"$" 后跟 2 个或更多十进制数字开头，令 digitCount 为 2，否则为 1。 - 令 digits 为
substring templateRemainder 从 1 到 1 + digitCount。 - 令 index 为
ℝ (StringToNumber (digits))。 断言 ：0 ≤ index ≤ 99。- 令 captureLen 为 captures 的元素个数。
- 如果 index > captureLen 且
digitCount = 2，则
- 注：两位数替换模式指定的索引超出捕获组数量时，视为一位数替换模式后跟一个字面数字。
- 令 digitCount 为 1。
- 令 digits 为
substring digits 从 0 到 1。 - 令 index 为
ℝ (StringToNumber (digits))。
- 令 ref 为
substring templateRemainder 从 0 到 1 + digitCount。 - 如果 1 ≤ index ≤ captureLen，则
- 令 capture 为 captures[index - 1]。
- 如果 capture 为
undefined ，则- 令 refReplacement 为空字符串。
- 否则，
- 令 refReplacement 为 capture。
- 否则，
- 令 refReplacement 为 ref。
- 如果 templateRemainder 以
- 否则，如果 templateRemainder 以
"$<" 开头，则- 令 gtPos 为
StringIndexOf (templateRemainder,">" , 0)。 - 如果 gtPos 为
not-found 或 namedCaptures 为undefined ，则- 令 ref 为
"$<" 。 - 令 refReplacement 为 ref。
- 令 ref 为
- 否则，
- 令 gtPos 为
- 否则，
- 令 ref 为
substring templateRemainder 从 0 到 1。 - 令 refReplacement 为 ref。
- 令 ref 为
- 令 refLength 为 ref 的长度。
- 将 templateRemainder 设为
substring templateRemainder 从 refLength。 - 将 result 设为
字符串拼接 result 和 refReplacement 的结果。
- 返回 result。
22.1.3.20 String.prototype.replaceAll ( searchValue, replaceValue )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 如果 searchValue 既不是
undefined 也不是null ，则- 令 isRegExp 为 ?
IsRegExp (searchValue)。 - 如果 isRegExp 为
true ，则- 令 flags 为 ?
Get (searchValue,"flags" )。 - 执行 ?
RequireObjectCoercible (flags)。 - 如果 ?
ToString (flags) 不包含"g" ，抛出TypeError 异常。
- 令 flags 为 ?
- 令 replacer 为 ?
GetMethod (searchValue,%Symbol.replace% )。 - 如果 replacer 不为
undefined ，则- 返回 ?
Call (replacer, searchValue, « O, replaceValue »)。
- 返回 ?
- 令 isRegExp 为 ?
- 令 string 为 ?
ToString (O)。 - 令 searchString 为 ?
ToString (searchValue)。 - 令 functionalReplace 为
IsCallable (replaceValue)。 - 如果 functionalReplace 为
false ，则- 将 replaceValue 设为 ?
ToString (replaceValue)。
- 将 replaceValue 设为 ?
- 令 searchLength 为 searchString 的长度。
- 令 advanceBy 为
max (1, searchLength)。 - 令 matchPositions 为新的空
List 。 - 令 position 为
StringIndexOf (string, searchString, 0)。 - 重复，直到 position 为
not-found ，- 将 position 添加到 matchPositions。
- 将 position 设为
StringIndexOf (string, searchString, position + advanceBy)。
- 令 endOfLastMatch 为 0。
- 令 result 为空字符串。
- 对于 matchPositions 中的每个元素 p，执行
- 令 preserved 为
substring string 从 endOfLastMatch 到 p。 - 如果 functionalReplace 为
true ，则 - 否则，
断言 ：replaceValue是 String 。- 令 captures 为新的空
List 。 - 令 replacement 为 !
GetSubstitution (searchString, string, p, captures,undefined , replaceValue)。
- 将 result 设为
字符串拼接 result、preserved 和 replacement 的结果。 - 将 endOfLastMatch 设为 p + searchLength。
- 令 preserved 为
- 如果 endOfLastMatch < string 的长度，则
- 返回 result。
22.1.3.21 String.prototype.search ( regexp )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 如果 regexp 既不是
undefined 也不是null ，则- 令 searcher 为 ?
GetMethod (regexp,%Symbol.search% )。 - 如果 searcher 不为
undefined ，则- 返回 ?
Call (searcher, regexp, « O »)。
- 返回 ?
- 令 searcher 为 ?
- 令 string 为 ?
ToString (O)。 - 令 rx 为 ?
RegExpCreate (regexp,undefined )。 - 返回 ?
Invoke (rx,%Symbol.search% , « string »)。
此方法有意设计为泛型；它不要求其
22.1.3.22 String.prototype.slice ( start, end )
该方法返回将此对象转换为字符串后的
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 len 为 S 的长度。
- 令 intStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 intStart = -∞，令 from 为 0。
- 否则若 intStart < 0，令 from 为
max (len + intStart, 0)。 - 否则，令 from 为
min (intStart, len)。 - 如果 end 为
undefined ，令 intEnd 为 len；否则令 intEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 intEnd = -∞，令 to 为 0。
- 否则若 intEnd < 0，令 to 为
max (len + intEnd, 0)。 - 否则，令 to 为
min (intEnd, len)。 - 如果 from ≥ to，返回空字符串。
- 返回
substring S 从 from 到 to。
此方法有意设计为泛型；它不要求其
22.1.3.23 String.prototype.split ( separator, limit )
该方法返回一个数组，将此对象转换为字符串后的子串存储在其中。子串是通过从左到右查找 separator
的出现位置确定的；这些出现位置不会包含在返回数组的任何字符串中，而是用来分割字符串。separator 的值可以是任意长度的字符串，也可以是具有
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 如果 separator 既不是
undefined 也不是null ，则- 令 splitter 为 ?
GetMethod (separator,%Symbol.split% )。 - 如果 splitter 不为
undefined ，则- 返回 ?
Call (splitter, separator, « O, limit »)。
- 返回 ?
- 令 splitter 为 ?
- 令 S 为 ?
ToString (O)。 - 如果 limit 为
undefined ，令 lim 为 232 - 1；否则令 lim 为ℝ (?ToUint32 (limit))。 - 令 R 为 ?
ToString (separator)。 - 如果 lim = 0，则
- 返回
CreateArrayFromList (« »)。
- 返回
- 如果 separator 为
undefined ，则- 返回
CreateArrayFromList (« S »)。
- 返回
- 令 separatorLength 为 R 的长度。
- 如果 separatorLength = 0，则
- 令 strLen 为 S 的长度。
- 令 outLen 为
clamping lim 在 0 和 strLen 之间的结果。 - 令 head 为
substring S 从 0 到 outLen。 - 令 codeUnits 为一个
List ，包含 head 的所有码元。 - 返回
CreateArrayFromList (codeUnits)。
- 如果 S 为空字符串，返回
CreateArrayFromList (« S »)。 - 令 substrings 为新的空
List 。 - 令 i 为 0。
- 令 j 为
StringIndexOf (S, R, 0)。 - 重复，直到 j 为
not-found ，- 令 T 为
substring S 从 i 到 j。 - 将 T 添加到 substrings。
- 如果 substrings 的元素个数为 lim，返回
CreateArrayFromList (substrings)。 - 将 i 设为 j + separatorLength。
- 将 j 设为
StringIndexOf (S, R, i)。
- 令 T 为
- 令 T 为
substring S 从 i。 - 将 T 添加到 substrings。
- 返回
CreateArrayFromList (substrings)。
separator 的值可以为空字符串。在这种情况下，separator
不会匹配输入字符串开头或结尾的空
如果
如果 separator 为
此方法有意设计为泛型；它不要求其
22.1.3.24 String.prototype.startsWith ( searchString [ , position ] )
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 isRegExp 为 ?
IsRegExp (searchString)。 - 如果 isRegExp 为
true ，抛出TypeError 异常。 - 令 searchStr 为 ?
ToString (searchString)。 - 令 len 为 S 的长度。
- 如果 position 为
undefined ，令 pos 为 0；否则令 pos 为 ?ToIntegerOrInfinity (position)。 - 令 start 为
clamping pos 在 0 和 len 之间的结果。 - 令 searchLength 为 searchStr 的长度。
- 如果 searchLength = 0，返回
true 。 - 令 end 为 start + searchLength。
- 如果 end > len，返回
false 。 - 令 substring 为
substring S 从 start 到 end。 - 如果 substring 等于 searchStr，返回
true 。 - 返回
false 。
如果 searchString（转换为字符串）的码元序列与本对象（转换为字符串）从 position
开始的对应码元相同，则返回
如果第一个参数是 RegExp 抛出异常，是为了允许后续标准版本定义支持此类参数值的扩展。
此方法有意设计为泛型；它不要求其
22.1.3.25 String.prototype.substring ( start, end )
该方法返回将此对象转换为字符串后的
如果任一参数为
如果 start 严格大于 end，则交换两者。
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 len 为 S 的长度。
- 令 intStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 end 为
undefined ，令 intEnd 为 len；否则令 intEnd 为 ?ToIntegerOrInfinity (end)。 - 令 finalStart 为
clamping intStart 在 0 和 len 之间的结果。 - 令 finalEnd 为
clamping intEnd 在 0 和 len 之间的结果。 - 令 from 为
min (finalStart, finalEnd)。 - 令 to 为
max (finalStart, finalEnd)。 - 返回
substring S 从 from 到 to。
此方法有意设计为泛型；它不要求其
22.1.3.26 String.prototype.toLocaleLowerCase ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按照 ECMA-402 规范实现此方法。如果 ECMAScript 实现未包含 ECMA-402 API，则使用以下规范：
该方法将 String 值作为 UTF-16 编码码点序列解释，如
其行为与 toLowerCase 相同，但旨在根据
该方法的可选参数含义由 ECMA-402 规范定义；未包含 ECMA-402 支持的实现不得将这些参数位置用于其他用途。
此方法有意设计为泛型；它不要求其
22.1.3.27 String.prototype.toLocaleUpperCase ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按照 ECMA-402 规范实现此方法。如果 ECMAScript 实现未包含 ECMA-402 API，则使用以下规范：
该方法将 String 值作为 UTF-16 编码码点序列解释，如
其行为与 toUpperCase 相同，但旨在根据
该方法的可选参数含义由 ECMA-402 规范定义；未包含 ECMA-402 支持的实现不得将这些参数位置用于其他用途。
此方法有意设计为泛型；它不要求其
22.1.3.28 String.prototype.toLowerCase ( )
该方法将 String 值作为 UTF-16 编码码点序列解释，如
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 sText 为
StringToCodePoints (S)。 - 令 lowerText 为根据 Unicode 默认大小写转换算法对 sText 执行 toLowercase。
- 令 L 为
CodePointsToString (lowerText)。 - 返回 L。
结果必须依据 Unicode 字符数据库中的区域无关大小写映射得出（这不仅包括 UnicodeData.txt
文件，还包括伴随的 SpecialCasing.txt
文件中所有区域无关的映射）。
某些码点的大小写映射可能产生多个码点。在这种情况下，结果字符串的长度可能与源字符串不同。由于 toUpperCase 和
toLowerCase
都具有上下文相关行为，这些方法并不对称。换言之，s.toUpperCase().toLowerCase() 不一定等于
s.toLowerCase()。
此方法有意设计为泛型；它不要求其
22.1.3.29 String.prototype.toString ( )
调用该方法时，执行以下步骤：
- 返回 ?
ThisStringValue (this 值)。
对于 String 对象，此方法恰好返回与 valueOf 方法相同的值。
22.1.3.30 String.prototype.toUpperCase ( )
该方法将 String 值作为 UTF-16 编码码点序列解释，如
其行为与 String.prototype.toLowerCase 完全相同，只是字符串使用 Unicode 默认大小写转换的 toUppercase
算法进行映射。
此方法有意设计为泛型；它不要求其
22.1.3.31 String.prototype.toWellFormed ( )
该方法返回此对象的字符串表示，将所有不是
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 S 为 ?
ToString (O)。 - 令 strLen 为 S 的长度。
- 令 k 为 0。
- 令 result 为空字符串。
- 重复，直到 k < strLen，
- 令 cp 为
CodePointAt (S, k)。 - 如果 cp.[[IsUnpairedSurrogate]] 为
true ，则- 将 result 设为
字符串拼接 result 和 0xFFFD（替换字符）的结果。
- 将 result 设为
- 否则，
- 将 result 设为
字符串拼接 result 和UTF16EncodeCodePoint (cp.[[CodePoint]]) 的结果。
- 将 result 设为
- 将 k 设为 k + cp.[[CodeUnitCount]]。
- 令 cp 为
- 返回 result。
22.1.3.32 String.prototype.trim ( )
该方法将 String 值作为 UTF-16 编码码点序列解释，如
调用该方法时，执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
TrimString (S,start+end )。
此方法有意设计为泛型；它不要求其
22.1.3.32.1 TrimString ( string, where )
抽象操作 TrimString 接收参数 string（
- 令 str 为 ?
RequireObjectCoercible (string)。 - 令 S 为 ?
ToString (str)。 - 如果 where 为
start ，则- 令 T 为 S 去除前导空白后的字符串值。
- 否则若 where 为
end ，则- 令 T 为 S 去除尾随空白后的字符串值。
- 否则，
断言 ：where 为start+end 。- 令 T 为 S 去除前导和尾随空白后的字符串值。
- 返回 T。
空白的定义为
22.1.3.33 String.prototype.trimEnd ( )
该方法将 String 值作为 UTF-16 编码码点序列解释，如
调用该方法时，执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
TrimString (S,end )。
此方法有意设计为泛型；它不要求其
22.1.3.34 String.prototype.trimStart ( )
该方法将 String 值作为 UTF-16 编码码点序列解释，如
调用该方法时，执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
TrimString (S,start )。
此方法有意设计为泛型；它不要求其
22.1.3.35 String.prototype.valueOf ( )
调用该方法时，执行以下步骤：
- 返回 ?
ThisStringValue (this 值)。
22.1.3.35.1 ThisStringValue ( value )
抽象操作 ThisStringValue 接收参数 value（
22.1.3.36 String.prototype [ %Symbol.iterator% ] ( )
该方法返回一个
调用该方法时，执行以下步骤：
- 令 O 为 ?
RequireObjectCoercible (this 值)。 - 令 s 为 ?
ToString (O)。 - 令 closure 为新的
抽象闭包 ，无参数，捕获 s，并在被调用时执行以下步骤：- 令 len 为 s 的长度。
- 令 position 为 0。
- 重复，直到 position < len，
- 令 cp 为
CodePointAt (s, position)。 - 令 nextIndex 为 position + cp.[[CodeUnitCount]]。
- 令 resultString 为
substring s 从 position 到 nextIndex。 - 将 position 设为 nextIndex。
- 执行 ?
GeneratorYield (CreateIteratorResultObject (resultString,false ))。
- 令 cp 为
- 返回
undefined 。
- 返回
CreateIteratorFromClosure (closure,"%StringIteratorPrototype%" ,%StringIteratorPrototype% )。
该方法的
22.1.4 String 实例的属性
String 实例是
String 实例具有
22.1.4.1 length
该 String 对象所表示的 String 值中的元素数量。
一旦 String 对象被初始化，此属性不可更改。它具有属性 { [[Writable]]:
22.1.5 String 迭代器对象
String 迭代器是表示对某个特定 String 实例对象的某次特定迭代的对象。String 迭代器对象没有命名的
22.1.5.1 %StringIteratorPrototype% 对象
%StringIteratorPrototype% 对象：
- 具有所有
String 迭代器对象 继承的属性。 - 是一个
普通对象 。 - 具有 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 具有以下属性：
22.1.5.1.1 %StringIteratorPrototype%.next ( )
- 返回 ?
GeneratorResume (this 值,empty ,"%StringIteratorPrototype%" )。
22.1.5.1.2 %StringIteratorPrototype% [ %Symbol.toStringTag% ]
该属性具有属性 { [[Writable]]:
22.2 RegExp（正则表达式）对象
RegExp 对象包含一个正则表达式和相关的标志（flags）。
正则表达式的形式和功能模仿了 Perl 5 编程语言中的正则表达式机制。
22.2.1 模式（Patterns）
RegExp
语法
每个 \u u
\u u
此处前两行等价于 CharacterClass。
本节中的多项产生式在
22.2.1.1 静态语义：早期错误（Static Semantics: Early Errors）
本节在
-
如果
CountLeftCapturingParensWithin (Pattern ) ≥ 232 - 1，则为语法错误。 -
如果
Pattern 包含两个不同的GroupSpecifier ，x 和 y，使得CapturingGroupName of x 等于CapturingGroupName of y，并且MightBothParticipate (x, y) 为true ，则为语法错误。
-
如果第一个
DecimalDigits 的 MV 严格大于第二个DecimalDigits 的 MV，则为语法错误。
-
如果
source text matched by RegularExpressionModifiers 中的码点有重复，则为语法错误。
-
如果第一个和第二个
RegularExpressionModifiers 匹配的源文本都为空，则为语法错误。 -
如果第一个
RegularExpressionModifiers 匹配的源文本中有重复的码点，则为语法错误。 -
如果第二个
RegularExpressionModifiers 匹配的源文本中有重复的码点，则为语法错误。 -
如果第一个
RegularExpressionModifiers 匹配的源文本中的任一码点也出现在第二个RegularExpressionModifiers 匹配的源文本中，则为语法错误。
-
如果
GroupSpecifiersThatMatch (GroupName ) 为空，则为语法错误。
-
如果
CapturingGroupNumber ofDecimalEscape 严格大于包含AtomEscape 的Pattern 的CountLeftCapturingParensWithin ，则为语法错误。
-
如果第一个或第二个
ClassAtom 的IsCharacterClass 为true ，则为语法错误。 -
如果第一个和第二个
ClassAtom 的IsCharacterClass 为false ，且第一个CharacterValue 严格大于第二个的，则为语法错误。
-
如果
ClassAtomNoDash 或ClassAtom 的IsCharacterClass 为true ，则为语法错误。 -
如果
ClassAtomNoDash 和ClassAtom 的IsCharacterClass 为false ，且第一个CharacterValue 严格大于第二个的，则为语法错误。
-
如果
CharacterValue ofRegExpUnicodeEscapeSequence 不是被IdentifierStartChar 词法语法产生式匹配的某个码点的数值，则为语法错误。
-
如果
RegExpIdentifierCodePoint ofRegExpIdentifierStart 未被UnicodeIDStart 词法语法产生式匹配，则为语法错误。
-
如果
CharacterValue ofRegExpUnicodeEscapeSequence 不是被IdentifierPartChar 词法语法产生式匹配的某个码点的数值，则为语法错误。
-
如果
RegExpIdentifierCodePoint ofRegExpIdentifierPart 未被UnicodeIDContinue 词法语法产生式匹配，则为语法错误。
-
如果
source text matched by UnicodePropertyName 不是 Unicode属性名 或“属性名 及别名”列（表 69 ）中列出的别名，则为语法错误。 -
如果
source text matched by UnicodePropertyValue 不是由source text matched by UnicodePropertyName 指定的 Unicode 属性或属性别名的属性值或属性值别名（参见PropertyValueAliases.txt），则为语法错误。
-
如果
source text matched by LoneUnicodePropertyNameOrValue 既不是PropertyValueAliases.txt中 General_Category (gc) 属性的属性值或别名，也不是表 70 “属性名及别名”列中列出的二进制属性或别名，也不是表 71 “属性名”列中列出的字符串的二进制属性，则为语法错误。 -
如果包围
Pattern 没有 [UnicodeSetsMode] 参数，且source text matched by LoneUnicodePropertyNameOrValue 是表 71 “属性名”列中列出的字符串的二进制属性，则为语法错误。
-
如果
MayContainStrings ofUnicodePropertyValueExpression 为true ，则为语法错误。
-
如果
MayContainStrings ofClassContents 为true ，则为语法错误。
-
如果
MayContainStrings ofClassContents 为true ，则为语法错误。
-
如果第一个
ClassSetCharacter 的CharacterValue 严格大于第二个ClassSetCharacter 的CharacterValue ，则为语法错误。
22.2.1.2 静态语义：CountLeftCapturingParensWithin (node)
抽象操作 CountLeftCapturingParensWithin 接收参数 node（一个 (
终结符匹配的 ( 模式字符：
本节在
调用时，执行以下步骤：
22.2.1.3 静态语义：CountLeftCapturingParensBefore (node)
抽象操作 CountLeftCapturingParensBefore 接收参数 node（一个
本节在
调用时，执行以下步骤：
断言 ：node 是正则表达式模式语法 中的某个产生式的实例。- 令 pattern 为包含 node 的
Pattern 。 - 返回 pattern 内部，出现在 node 之前或包含 node 的以下解析节点的数量：
22.2.1.4 静态语义：MightBothParticipate (x, y)
抽象操作 MightBothParticipate 接收参数 x（一个
断言 ：x 和 y 拥有同一个封闭的Pattern 。-
如果该封闭
Pattern 包含如下Disjunction :: Alternative | Disjunction 解析节点 ，使得 x 包含于Alternative 中且 y 包含于派生的Disjunction 中，或者 x 包含于派生的Disjunction 中且 y 包含于Alternative 中，则返回false 。 - 返回
true 。
22.2.1.5 静态语义：CapturingGroupNumber
本节在
在以下产生式中分段定义：
- 返回
NonZeroDigit 的 MV。
- 令 n 为
DecimalDigits 中码点的数量。 - 返回 (
NonZeroDigit 的 MV × 10n 加DecimalDigits 的 MV)。
“
22.2.1.6 静态语义：IsCharacterClass
本节在
在以下产生式中分段定义：
- 返回
false 。
- 返回
true 。
22.2.1.7 静态语义：CharacterValue
本节在
在以下产生式中分段定义：
- 返回 U+002D（连字符 HYPHEN-MINUS）的数值。
- 令 ch 为
SourceCharacter 匹配的码点。 - 返回 ch 的数值。
- 返回 U+0008（退格 BACKSPACE）的数值。
- 返回 U+002D（连字符 HYPHEN-MINUS）的数值。
- 按照
表 67 返回数值。
| ControlEscape | 数值 | 码点 | Unicode 名称 | 符号 |
|---|---|---|---|---|
t |
9 | U+0009 |
CHARACTER TABULATION | <HT> |
n |
10 | U+000A |
LINE FEED (LF) | <LF> |
v |
11 | U+000B |
LINE TABULATION | <VT> |
f |
12 | U+000C |
FORM FEED (FF) | <FF> |
r |
13 | U+000D |
CARRIAGE RETURN (CR) | <CR> |
- 令 ch 为
AsciiLetter 匹配的码点。 - 令 i 为 ch 的数值。
- 返回 i 除以 32 的余数。
- 返回 U+0000（NULL）的数值。
\0 表示 <NUL> 字符，且不能后跟十进制数字。
- 返回
HexEscapeSequence 的 MV。
- 令 lead 为
CharacterValue ofHexLeadSurrogate 。 - 令 trail 为
CharacterValue ofHexTrailSurrogate 。 - 令 cp 为
UTF16SurrogatePairToCodePoint (lead, trail)。 - 返回 cp 的数值。
- 返回
Hex4Digits 的 MV。
- 返回
CodePoint 的 MV。
- 返回
Hex4Digits 的 MV。
- 令 ch 为
IdentityEscape 匹配的码点。 - 返回 ch 的数值。
- 令 ch 为
SourceCharacter 匹配的码点。 - 返回 ch 的数值。
- 令 ch 为
ClassSetReservedPunctuator 匹配的码点。 - 返回 ch 的数值。
- 返回 U+0008（退格 BACKSPACE）的数值。
22.2.1.8 静态语义：MayContainStrings
- 返回
false 。
-
如果
source text matched by LoneUnicodePropertyNameOrValue 是表 71 “属性名”列中列出的字符串的二进制属性，则返回true 。 - 返回
false 。
-
如果
ClassUnion 存在，返回MayContainStrings ofClassUnion 。 - 返回
false 。
-
如果
MayContainStrings ofClassSetOperand 为true ，返回true 。 -
如果
ClassUnion 存在，返回MayContainStrings ofClassUnion 。 - 返回
false 。
-
如果
MayContainStrings of 第一个ClassSetOperand 为false ，返回false 。 -
如果
MayContainStrings of 第二个ClassSetOperand 为false ，返回false 。 - 返回
true 。
-
如果
MayContainStrings ofClassIntersection 为false ，返回false 。 -
如果
MayContainStrings ofClassSetOperand 为false ，返回false 。 - 返回
true 。
- 返回第一个
MayContainStrings ofClassSetOperand 。
-
如果
MayContainStrings ofClassString 为true ，返回true 。 -
返回
MayContainStrings ofClassStringDisjunctionContents 。
- 返回
true 。
- 如果
NonEmptyClassString 存在，返回true 。 - 返回
false 。
22.2.1.9 静态语义：GroupSpecifiersThatMatch (thisGroupName)
抽象操作 GroupSpecifiersThatMatch 接收参数 thisGroupName（一个
- 令 name 为
CapturingGroupName of thisGroupName。 - 令 pattern 为包含 thisGroupName 的
Pattern 。 - 令 result 为一个新的空
List 。 - 对于 pattern 包含的每个
GroupSpecifier gs，执行： - 如果 gs 的
CapturingGroupName 等于 name，则： - 将 gs 添加至 result。
- 返回 result。
22.2.1.10 静态语义：CapturingGroupName
- 令 idTextUnescaped 为
RegExpIdentifierCodePoints ofRegExpIdentifierName 。 - 返回
CodePointsToString (idTextUnescaped)。
22.2.1.11 静态语义：RegExpIdentifierCodePoints
- 令 cp 为
RegExpIdentifierCodePoint ofRegExpIdentifierStart 。 - 返回 « cp »。
- 令 cps 为派生的
RegExpIdentifierCodePoints ofRegExpIdentifierName 。 - 令 cp 为
RegExpIdentifierCodePoint ofRegExpIdentifierPart 。 - 返回
list-concatenation of cps 和 « cp »。
22.2.1.12 静态语义：RegExpIdentifierCodePoint
- 返回
IdentifierStartChar 匹配的码点。
- 返回
IdentifierPartChar 匹配的码点。
- 返回数值为
CharacterValue ofRegExpUnicodeEscapeSequence 的码点。
- 令 lead 为
UnicodeLeadSurrogate 匹配的码点的数值所对应的码元。 - 令 trail 为
UnicodeTrailSurrogate 匹配的码点的数值所对应的码元。 - 返回
UTF16SurrogatePairToCodePoint (lead, trail)。
22.2.2 模式语义（Pattern Semantics）
正则表达式模式会按照下述过程被转换为一个
如果一个 u 也不包含 v，则它是 BMP 模式。否则，它是 Unicode 模式。BMP 模式会针对被解释为由处于基本多文种平面（BMP）范围内的
Unicode 码点组成的 16 位值序列的字符串进行匹配。Unicode 模式则针对被解释为用 UTF-16 编码的 Unicode 码点序列的字符串进行匹配。在描述 BMP
模式行为时，“character” 表示单个 16 位的 Unicode BMP 码点。在描述 Unicode 模式行为时，“character” 表示一个 UTF-16
编码的码点（
例如，假设一个模式在源文本中表示为单个非 BMP 字符 U+1D11E（MUSICAL SYMBOL G CLEF）。作为 Unicode 模式解释时，它是一个仅包含该码点
U+1D11E 的元素（字符）
模式会以 ECMAScript 字符串值的形式传递给 RegExp
实现不一定真的需要进行这些 UTF-16 的转换，但本规范要求，模式匹配的语义要如同进行了这些转换一样。
22.2.2.1 符号说明（Notation）
下述描述使用以下内部数据结构：
-
CharSetElement（字符集元素）是以下两种实体之一：
-
若 rer.[[UnicodeSets]] 为
false ，CharSetElement 就是前述“模式语义”意义下的字符。 -
若 rer.[[UnicodeSets]] 为
true ，CharSetElement 是一个序列，其元素为“模式语义”意义下的字符。包括空序列、单字符序列和多字符序列。为了方便，处理这类 CharSetElement 时，单个字符和单字符序列可以互换。
-
若 rer.[[UnicodeSets]] 为
- CharSet（字符集）是 CharSetElement 的数学集合。
-
CaptureRange（捕获范围）是一个
Record { [[StartIndex]], [[EndIndex]] }，表示捕获所包含的字符范围，其中 [[StartIndex]] 是整数 ，表示 Input 中范围的起始索引（包含），[[EndIndex]] 是整数 ，表示 Input 中范围的结束索引（不包含）。任何CaptureRange 都必须满足 [[StartIndex]] ≤ [[EndIndex]]。 -
MatchState（匹配状态）是一个
Record { [[Input]], [[EndIndex]], [[Captures]] }，其中 [[Input]] 是待匹配字符串的字符List ，[[EndIndex]] 是整数 ，[[Captures]] 是一个List ，每个元素对应模式中的一个左捕获括号 。MatchStates 用于表达正则表达式匹配算法中的部分匹配状态。[[EndIndex]] 是当前为止最后一个已匹配输入字符的索引加一，[[Captures]] 保存捕获括号的结果。n 个 [[Captures]] 元素，要么是CaptureRange ，表示第 n 个捕获括号捕获的范围，要么为undefined 表示还未到达。由于回溯，匹配过程中可能同时存在多个MatchStates 。 -
MatcherContinuation（匹配延续）是一个
抽象闭包 ，接收一个MatchState 参数，返回一个MatchState 或failure 。MatcherContinuation 试图将模式剩余部分（由闭包捕获的值指定）与 Input 匹配，从当前MatchState 状态开始。如果匹配成功，返回最终到达的MatchState ，否则返回failure 。 -
Matcher（匹配器）是一个
抽象闭包 ，接收两个参数——MatchState 和MatcherContinuation ，返回MatchState 或failure 。Matcher 试图将模式的某一中间子模式（由闭包捕获的值指定）与MatchState 的 [[Input]] 匹配，从传入的中间状态开始。MatcherContinuation 参数应为匹配剩余模式的闭包。匹配子模式获得新的MatchState 后，Matcher 会在此状态上调用MatcherContinuation 检查剩余模式是否也能匹配。如果可以，返回MatchState ；否则，匹配器可能会在其选择点尝试不同的选择，不断调用MatcherContinuation ，直到成功或无可能性为止。
22.2.2.1.1 RegExp 记录（RegExp Records）
RegExp Record 是一个
它包含如下字段：
| 字段名 | 值 | 含义 |
|---|---|---|
| [[IgnoreCase]] | 布尔值 | 指示 RegExp 标志中是否出现 |
| [[Multiline]] | 布尔值 | 指示 RegExp 标志中是否出现 |
| [[DotAll]] | 布尔值 | 指示 RegExp 标志中是否出现 |
| [[Unicode]] | 布尔值 | 指示 RegExp 标志中是否出现 |
| [[UnicodeSets]] | 布尔值 | 指示 RegExp 标志中是否出现 |
| [[CapturingGroupsCount]] | 非负 |
RegExp 模式中的 |
22.2.2.2 运行时语义：CompilePattern
- 令 m 为
CompileSubpattern ofDisjunction ，参数为 rer 和forward 。 -
返回一个新
抽象闭包 ，参数为 (Input, index)，捕获 rer 和 m，调用时执行以下步骤：断言 ：Input 为字符List 。断言 ：0 ≤ index ≤ Input 的元素数量。- 令 c 为一个新
MatcherContinuation ，参数 (y)，不捕获任何内容，调用时： 断言 ：y 为MatchState 。- 返回 y。
- 令 cap 为 rer.[[CapturingGroupsCount]] 个
undefined 的List ，索引从 1 到 rer.[[CapturingGroupsCount]]。 - 令 x 为
MatchState { [[Input]]: Input, [[EndIndex]]: index, [[Captures]]: cap }。 - 返回 m(x, c)。
Pattern 会被编译为
22.2.2.3 运行时语义：CompileSubpattern
本节在
在以下产生式中分段定义：
- 令 m1 为
CompileSubpattern ofAlternative ，参数为 rer 和 direction。 - 令 m2 为
CompileSubpattern ofDisjunction ，参数为 rer 和 direction。 - 返回
MatchTwoAlternatives (m1, m2)。
| 正则表达式操作符分隔两个备选项。模式首先尝试匹配左侧 | 跳过的部分中的捕获括号，其值为
/a|ab/.exec("abc")返回结果为
/((a)|(ab))((c)|(bc))/.exec("abc")返回数组：
["abc", "a", "a", undefined, "bc", undefined, "bc"]而不是：
["abc", "ab", undefined, "ab", "c", "c", undefined]两个备选项的尝试顺序与 direction 的值无关。
- 返回
EmptyMatcher ()。
- 令 m1 为
CompileSubpattern ofAlternative ，参数为 rer 和 direction。 - 令 m2 为
CompileSubpattern ofTerm ，参数为 rer 和 direction。 - 返回
MatchSequence (m1, m2, direction)。
连续的
- 返回
CompileAssertion ofAssertion ，参数为 rer。
所得
- 返回
CompileAtom ofAtom ，参数为 rer 和 direction。
- 令 m 为
CompileAtom ofAtom ，参数为 rer 和 direction。 - 令 q 为
CompileQuantifier ofQuantifier 。 断言 ：q.[[Min]] ≤ q.[[Max]]。- 令 parenIndex 为
CountLeftCapturingParensBefore (Term )。 - 令 parenCount 为
CountLeftCapturingParensWithin (Atom )。 - 返回一个新
Matcher ，参数为 (x, c)，捕获 m、q、parenIndex 和 parenCount，调用时： 断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。- 返回
RepeatMatcher (m, q.[[Min]], q.[[Max]], q.[[Greedy]], x, c, parenIndex, parenCount)。
22.2.2.3.1 RepeatMatcher (m, min, max, greedy, x, c, parenIndex, parenCount)
抽象操作 RepeatMatcher 接收参数 m（一个
- 如果 max = 0，返回 c(x)。
-
令 d 为一个新
MatcherContinuation ，参数 (y)，捕获 m、min、max、greedy、x、c、parenIndex、parenCount，调用时：断言 ：y 为MatchState 。- 如果 min = 0 且 y.[[EndIndex]] = x.[[EndIndex]]，返回
failure 。 - 如果 min = 0，令 min2 为 0；否则，令 min2 为 min - 1。
- 如果 max = +∞，令 max2 为 +∞；否则，令 max2 为 max - 1。
- 返回
RepeatMatcher (m, min2, max2, greedy, y, c, parenIndex, parenCount)。
- 令 cap 为 x.[[Captures]] 的副本。
-
对于
整数 k，在闭区间 parenIndex + 1 到 parenIndex + parenCount，令 cap[k] =undefined 。 - 令 Input 为 x.[[Input]]。
- 令 e 为 x.[[EndIndex]]。
- 令 xr 为
MatchState { [[Input]]: Input, [[EndIndex]]: e, [[Captures]]: cap }。 - 如果 min ≠ 0，返回 m(xr, d)。
- 如果 greedy 为
false ，则： - 令 z 为 c(x)。
- 如果 z 不为
failure ，返回 z。 - 返回 m(xr, d)。
- 令 z 为 m(xr, d)。
- 如果 z 不为
failure ，返回 z。 - 返回 c(x)。
一个
22.2.2.3.2 EmptyMatcher ( )
抽象操作 EmptyMatcher 无参数，返回一个
-
返回一个新
Matcher ，参数 (x, c)，不捕获任何内容，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。- 返回 c(x)。
22.2.2.3.3 MatchTwoAlternatives (m1, m2)
抽象操作 MatchTwoAlternatives 接收参数 m1（
-
返回一个新
Matcher ，参数 (x, c)，捕获 m1 和 m2，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。- 令 r 为 m1(x, c)。
- 若 r 非
failure ，返回 r。 - 返回 m2(x, c)。
22.2.2.3.4 MatchSequence (m1, m2, direction)
抽象操作 MatchSequence 接收参数 m1（
- 如果 direction 为
forward ，则： -
返回一个新
Matcher ，参数 (x, c)，捕获 m1 和 m2，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。-
令 d 为一个新
MatcherContinuation ，参数 (y)，捕获 c 和 m2，调用时：断言 ：y 为MatchState 。- 返回 m2(y, c)。
- 返回 m1(x, d)。
- 否则：
断言 ：direction 为backward 。-
返回一个新
Matcher ，参数 (x, c)，捕获 m1 和 m2，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。-
令 d 为一个新
MatcherContinuation ，参数 (y)，捕获 c 和 m1，调用时：断言 ：y 为MatchState 。- 返回 m1(y, c)。
- 返回 m2(x, d)。
22.2.2.4 运行时语义：CompileAssertion
本节在
在以下产生式中分段定义：
-
返回一个新
Matcher ，参数 (x, c)，捕获 rer，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。- 令 Input = x.[[Input]]。
- 令 e = x.[[EndIndex]]。
- 如果 e = 0，或 rer.[[Multiline]]
为
true 且 Input[e - 1] 匹配LineTerminator ，则： - 返回 c(x)。
- 返回
failure 。
即使正则表达式使用 y 标志，^ 也只会在 Input 开头或（若
rer.[[Multiline]] 为
-
返回一个新
Matcher ，参数 (x, c)，捕获 rer，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。- 令 Input = x.[[Input]]。
- 令 e = x.[[EndIndex]]。
- 令 InputLength = Input 的元素数量。
- 如果 e = InputLength，或 rer.[[Multiline]] 为
true 且 Input[e] 匹配LineTerminator ，则： - 返回 c(x)。
- 返回
failure 。
-
返回一个新
Matcher ，参数 (x, c)，捕获 rer，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。- 令 Input = x.[[Input]]。
- 令 e = x.[[EndIndex]]。
- 令 a =
IsWordChar (rer, Input, e - 1)。 - 令 b =
IsWordChar (rer, Input, e)。 - 如果 a 为
true 且 b 为false ，或 a 为false 且 b 为true ，返回 c(x)。 - 返回
failure 。
-
返回一个新
Matcher ，参数 (x, c)，捕获 rer，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。- 令 Input = x.[[Input]]。
- 令 e = x.[[EndIndex]]。
- 令 a =
IsWordChar (rer, Input, e - 1)。 - 令 b =
IsWordChar (rer, Input, e)。 - 如果 a 和 b 同为
true 或同为false ，返回 c(x)。 - 返回
failure 。
- 令 m 为
CompileSubpattern ofDisjunction ，参数为 rer 和forward 。 -
返回一个新
Matcher ，参数 (x, c)，捕获 m，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。-
令 d 为一个新
MatcherContinuation ，参数 (y)，不捕获内容，调用时：断言 ：y 为MatchState 。- 返回 y。
- 令 r 为 m(x, d)。
- 若 r 为
failure ，返回failure 。 断言 ：r 为MatchState 。- 令 cap = r.[[Captures]]。
- 令 Input = x.[[Input]]。
- 令 xe = x.[[EndIndex]]。
- 令 z 为
MatchState { [[Input]]: Input, [[EndIndex]]: xe, [[Captures]]: cap }。 - 返回 c(z)。
形式 (?= )
表示零宽度正向先行断言。其内部模式需在当前位置匹配成功，但当前位置不会推进。lookahead 内部无回溯。
- 令 m 为
CompileSubpattern ofDisjunction ，参数为 rer 和forward 。 -
返回一个新
Matcher ，参数 (x, c)，捕获 m，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。-
令 d 为一个新
MatcherContinuation ，参数 (y)，不捕获内容，调用时：断言 ：y 为MatchState 。- 返回 y。
- 令 r 为 m(x, d)。
- 若 r 非
failure ，返回failure 。 - 返回 c(x)。
形式 (?! )
表示零宽度负向先行断言。其内部模式需在当前位置匹配失败。
- 令 m 为
CompileSubpattern ofDisjunction ，参数为 rer 和backward 。 -
返回一个新
Matcher ，参数 (x, c)，捕获 m，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。-
令 d 为一个新
MatcherContinuation ，参数 (y)，不捕获内容，调用时：断言 ：y 为MatchState 。- 返回 y。
- 令 r 为 m(x, d)。
- 若 r 为
failure ，返回failure 。 断言 ：r 为MatchState 。- 令 cap = r.[[Captures]]。
- 令 Input = x.[[Input]]。
- 令 xe = x.[[EndIndex]]。
- 令 z 为
MatchState { [[Input]]: Input, [[EndIndex]]: xe, [[Captures]]: cap }。 - 返回 c(z)。
- 令 m 为
CompileSubpattern ofDisjunction ，参数为 rer 和backward 。 -
返回一个新
Matcher ，参数 (x, c)，捕获 m，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。-
令 d 为一个新
MatcherContinuation ，参数 (y)，不捕获内容，调用时：断言 ：y 为MatchState 。- 返回 y。
- 令 r 为 m(x, d)。
- 若 r 非
failure ，返回failure 。 - 返回 c(x)。
22.2.2.4.1 IsWordChar (rer, Input, e)
抽象操作 IsWordChar 接收参数 rer（
- 令 InputLength = Input 的元素数量。
- 如果 e = -1 或 e = InputLength，返回
false 。 - 令 c = Input[e]。
- 如果
WordCharacters (rer) 包含 c，返回true 。 - 返回
false 。
22.2.2.5 运行时语义：CompileQuantifier
- 令 qp 为
CompileQuantifierPrefix ofQuantifierPrefix 。 - 返回
Record { [[Min]]: qp.[[Min]], [[Max]]: qp.[[Max]], [[Greedy]]:true }。
- 令 qp 为
CompileQuantifierPrefix ofQuantifierPrefix 。 - 返回
Record { [[Min]]: qp.[[Min]], [[Max]]: qp.[[Max]], [[Greedy]]:false }。
22.2.2.6 运行时语义：CompileQuantifierPrefix
- 返回
Record { [[Min]]: 0, [[Max]]: +∞ }。
- 返回
Record { [[Min]]: 1, [[Max]]: +∞ }。
- 返回
Record { [[Min]]: 0, [[Max]]: 1 }。
- 令 i 为
DecimalDigits 的 MV（见12.9.3 ）。 - 返回
Record { [[Min]]: i, [[Max]]: i }。
- 令 i 为
DecimalDigits 的 MV。 - 返回
Record { [[Min]]: i, [[Max]]: +∞ }。
- 令 i 为第一个
DecimalDigits 的 MV。 - 令 j 为第二个
DecimalDigits 的 MV。 - 返回
Record { [[Min]]: i, [[Max]]: j }。
22.2.2.7 运行时语义：CompileAtom
本节在
在以下产生式中分段定义：
- 令 ch 为
PatternCharacter 匹配的字符。 - 令 A 为仅包含字符 ch 的单元素
CharSet 。 - 返回
CharacterSetMatcher (rer, A,false , direction)。
- 令 A 为
AllCharacters (rer)。 - 如果 rer.[[DotAll]] 不为
true ，则： - 从 A 中移除所有
LineTerminator 产生式右侧的码点对应的字符。 - 返回
CharacterSetMatcher (rer, A,false , direction)。
- 令 cc 为
CompileCharacterClass ofCharacterClass ，参数为 rer。 - 令 cs = cc.[[CharSet]]。
- 如果 rer.[[UnicodeSets]] 为
false ，或 cs 的所有CharSetElement 都是单字符（包括 cs 为空），则返回CharacterSetMatcher (rer, cs, cc.[[Invert]], direction)。 断言 ：cc.[[Invert]] 为false 。- 令 lm 为
Matchers 的空List 。 - 对于 cs 中每个包含多个字符的
CharSetElement s（按长度降序遍历），执行： - 令 cs2 为仅包含 s 最后一个码点的单元素
CharSet 。 - 令 m2 为
CharacterSetMatcher (rer, cs2,false , direction)。 - 对于 s 中每个码点 c1（从倒数第二个码点开始反向遍历），执行：
- 令 cs1 为仅包含 c1 的单元素
CharSet 。 - 令 m1 为
CharacterSetMatcher (rer, cs1,false , direction)。 - 令 m2 =
MatchSequence (m1, m2, direction)。 - 将 m2 添加到 lm。
- 令 singles 为 cs 中所有单字符
CharSetElement 组成的CharSet 。 - 将
CharacterSetMatcher (rer, singles,false , direction) 添加到 lm。 - 如果 cs 包含空序列，则将
EmptyMatcher () 添加到 lm。 - 令 m2 为 lm 的最后一个
Matcher 。 - 对于 lm 中每个
Matcher m1（从倒数第二个元素开始反向遍历），执行： - 令 m2 =
MatchTwoAlternatives (m1, m2)。 - 返回 m2。
- 令 m 为
CompileSubpattern ofDisjunction ，参数为 rer 和 direction。 - 令 parenIndex =
CountLeftCapturingParensBefore (Atom )。 - 返回一个新
Matcher ，参数 (x, c)，捕获 direction、m、parenIndex，调用时： 断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。- 令 d 为一个新
MatcherContinuation ，参数 (y)，捕获 x、c、direction、parenIndex，调用时： 断言 ：y 为MatchState 。- 令 cap 为 y.[[Captures]] 的副本。
- 令 Input = x.[[Input]]。
- 令 xe = x.[[EndIndex]]。
- 令 ye = y.[[EndIndex]]。
- 如果 direction 为
forward ，则： 断言 ：xe ≤ ye。- 令 r 为
CaptureRange { [[StartIndex]]: xe, [[EndIndex]]: ye }。 - 否则：
断言 ：direction 为backward 。断言 ：ye ≤ xe。- 令 r 为
CaptureRange { [[StartIndex]]: ye, [[EndIndex]]: xe }。 - 设置 cap[parenIndex + 1] = r。
- 令 z 为
MatchState { [[Input]]: Input, [[EndIndex]]: ye, [[Captures]]: cap }。 - 返回 c(z)。
- 返回 m(x, d)。
形如 ( )
的括号既用于分组，也用于保存匹配结果。可以通过反向引用、替换字符串或结果数组使用该结果。用 (?: ... )
可禁用捕获行为。
- 令 addModifiers 为
source text matched by RegularExpressionModifiers 。 - 令 removeModifiers 为空字符串。
- 令 modifiedRer =
UpdateModifiers (rer,CodePointsToString (addModifiers), removeModifiers)。 - 返回
CompileSubpattern ofDisjunction ，参数为 modifiedRer 和 direction。
- 令 addModifiers 为
source text matched by 第一个RegularExpressionModifiers 。 - 令 removeModifiers 为
source text matched by 第二个RegularExpressionModifiers 。 - 令 modifiedRer =
UpdateModifiers (rer,CodePointsToString (addModifiers),CodePointsToString (removeModifiers))。 - 返回
CompileSubpattern ofDisjunction ，参数为 modifiedRer 和 direction。
- 令 n 为
CapturingGroupNumber ofDecimalEscape 。 断言 ：n ≤ rer.[[CapturingGroupsCount]]。- 返回
BackreferenceMatcher (rer, « n », direction)。
形如 \ 后跟非零十进制数字 n 的转义序列，匹配第 n 个捕获括号的结果。括号数不足 n
是错误。若 n 个括号有但第 n 个未捕获内容，则反向引用总是成功。
- 令 cv 为
CharacterValue ofCharacterEscape 。 - 令 ch 为字符值为 cv 的字符。
- 令 A 为仅包含字符 ch 的单元素
CharSet 。 - 返回
CharacterSetMatcher (rer, A,false , direction)。
- 令 cs 为
CompileToCharSet ofCharacterClassEscape ，参数为 rer。 - 如果 rer.[[UnicodeSets]] 为
false ，或 cs 的所有CharSetElement 都是单字符（包括 cs 为空），则返回CharacterSetMatcher (rer, cs,false , direction)。 - 令 lm 为
Matchers 的空List 。 - 对于 cs 中每个包含多个字符的
CharSetElement s（按长度降序遍历），执行： - 令 cs2 为仅包含 s 最后一个码点的单元素
CharSet 。 - 令 m2 为
CharacterSetMatcher (rer, cs2,false , direction)。 - 对于 s 中每个码点 c1（从倒数第二个码点开始反向遍历），执行：
- 令 cs1 为仅包含 c1 的单元素
CharSet 。 - 令 m1 为
CharacterSetMatcher (rer, cs1,false , direction)。 - 令 m2 =
MatchSequence (m1, m2, direction)。 - 将 m2 添加到 lm。
- 令 singles 为 cs 中所有单字符
CharSetElement 组成的CharSet 。 - 将
CharacterSetMatcher (rer, singles,false , direction) 添加到 lm。 - 如果 cs 包含空序列，则将
EmptyMatcher () 添加到 lm。 - 令 m2 为 lm 的最后一个
Matcher 。 - 对于 lm 中每个
Matcher m1（从倒数第二个元素开始反向遍历），执行： - 令 m2 =
MatchTwoAlternatives (m1, m2)。 - 返回 m2。
- 令 matchingGroupSpecifiers 为
GroupSpecifiersThatMatch (GroupName )。 - 令 parenIndices 为一个新的空
List 。 - 对于 matchingGroupSpecifiers 中的每一个
GroupSpecifier groupSpecifier，执行： - 令 parenIndex =
CountLeftCapturingParensBefore (groupSpecifier)。 - 将 parenIndex 添加到 parenIndices。
- 返回
BackreferenceMatcher (rer, parenIndices, direction)。
22.2.2.7.1 CharacterSetMatcher (rer, A, invert, direction)
抽象操作 CharacterSetMatcher 接收参数 rer（
- 如果 rer.[[UnicodeSets]] 为
true ，则： 断言 ：invert 为false 。断言 ：A 的每个CharSetElement 都是单字符。-
返回一个新
Matcher ，参数 (x, c)，捕获 rer、A、invert、direction，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。- 令 Input = x.[[Input]]。
- 令 e = x.[[EndIndex]]。
- 若 direction 为
forward ，令 f = e + 1。 - 否则，令 f = e - 1。
- 令 InputLength = Input 的元素数量。
- 若 f < 0 或 f > InputLength，返回
failure 。 - 令 index =
min (e, f)。 - 令 ch = Input[index]。
- 令 cc =
Canonicalize (rer, ch)。 - 如果存在 A 中仅含字符 a 的
CharSetElement ，且Canonicalize (rer, a) 等于 cc，则 found =true ，否则 found =false 。 - 若 invert 为
false 且 found 为false ，返回failure 。 - 若 invert 为
true 且 found 为true ，返回failure 。 - 令 cap = x.[[Captures]]。
- 令 y =
MatchState { [[Input]]: Input, [[EndIndex]]: f, [[Captures]]: cap }。 - 返回 c(y)。
22.2.2.7.2 BackreferenceMatcher (rer, ns, direction)
抽象操作 BackreferenceMatcher 接收参数 rer（
-
返回一个新
Matcher ，参数 (x, c)，捕获 rer、ns、direction，调用时：断言 ：x 为MatchState 。断言 ：c 为MatcherContinuation 。- 令 Input = x.[[Input]]。
- 令 cap = x.[[Captures]]。
- 令 r =
undefined 。 - 对于 ns 中的每个
整数 n，执行： - 若 cap[n] 非
undefined ，则： 断言 ：r 为undefined 。- 令 r = cap[n]。
- 若 r 为
undefined ，返回 c(x)。 - 令 e = x.[[EndIndex]]。
- 令 rs = r.[[StartIndex]]。
- 令 re = r.[[EndIndex]]。
- 令 len = re - rs。
- 若 direction 为
forward ，令 f = e + len。 - 否则，令 f = e - len。
- 令 InputLength = Input 的元素数量。
- 若 f < 0 或 f > InputLength，返回
failure 。 - 令 g =
min (e, f)。 - 若存在 0（含）到 len（不含）间的
整数 i，使得Canonicalize (rer, Input[rs+i]) ≠Canonicalize (rer, Input[g+i])，返回failure 。 - 令 y =
MatchState { [[Input]]: Input, [[EndIndex]]: f, [[Captures]]: cap }。 - 返回 c(y)。
22.2.2.7.3 Canonicalize (rer, ch)
抽象操作 Canonicalize 接收参数 rer（
- 若
HasEitherUnicodeFlag (rer) 为true 且 rer.[[IgnoreCase]] 为true ，则： - 若
CaseFolding.txt提供了 ch 的简单或通用大小写折叠映射，则返回应用该映射后的 ch。 - 返回 ch。
- 若 rer.[[IgnoreCase]] 为
false ，返回 ch。 断言 ：ch 是 UTF-16 码元。- 令 cp 为 ch 的数值对应的码点。
- 令 u 为根据 Unicode 默认大小写转换算法 toUppercase(« cp »)。
- 令 uStr =
CodePointsToString (u)。 - 若 uStr 长度 ≠ 1，返回 ch。
- 令 cu = uStr 的唯一码元。
- 若 ch 数值 ≥ 128 且 cu 数值 < 128，返回 ch。
- 返回 cu。
当 ß 不会变为 ss 或
SS）。但部分非Basic Latin字符可映射为Basic Latin内字符，如 ſ 会折叠为
s，K 会折叠为 k，因此如 /[a-z]/ui
可匹配这些字符。
当 Ω（U+2126）用 toUppercase 仍为自身，但 toCasefold 会变为
ω。所以 "\u2126" 能被 /[ω]/ui 匹配，不能被
/[ω]/i 匹配。非Basic Latin的字符不会映射到Basic Latin内字符。
22.2.2.7.4 UpdateModifiers (rer, add, remove)
抽象操作 UpdateModifiers 接收参数 rer（
断言 ：add 与 remove 没有公共元素。- 令 ignoreCase = rer.[[IgnoreCase]]。
- 令 multiline = rer.[[Multiline]]。
- 令 dotAll = rer.[[DotAll]]。
- 令 unicode = rer.[[Unicode]]。
- 令 unicodeSets = rer.[[UnicodeSets]]。
- 令 capturingGroupsCount = rer.[[CapturingGroupsCount]]。
- 如果 remove 包含
"i" ，则令 ignoreCase =false 。 - 否则若 add 包含
"i" ，则令 ignoreCase =true 。 - 如果 remove 包含
"m" ，则令 multiline =false 。 - 否则若 add 包含
"m" ，则令 multiline =true 。 - 如果 remove 包含
"s" ，则令 dotAll =false 。 - 否则若 add 包含
"s" ，则令 dotAll =true 。 -
返回
RegExp Record { [[IgnoreCase]]: ignoreCase, [[Multiline]]: multiline, [[DotAll]]: dotAll, [[Unicode]]: unicode, [[UnicodeSets]]: unicodeSets, [[CapturingGroupsCount]]: capturingGroupsCount }。
22.2.2.8 运行时语义：CompileCharacterClass
- 令 A 为
CompileToCharSet ofClassContents ，参数为 rer。 - 返回
Record { [[CharSet]]: A, [[Invert]]:false }。
- 令 A 为
CompileToCharSet ofClassContents ，参数为 rer。 - 如果 rer.[[UnicodeSets]] 为
true ，则： - 返回
Record { [[CharSet]]:CharacterComplement (rer, A), [[Invert]]:false }。 - 返回
Record { [[CharSet]]: A, [[Invert]]:true }。
22.2.2.9 运行时语义：CompileToCharSet
本节在
在以下产生式中分段定义：
- 返回空
CharSet 。
- 令 A =
CompileToCharSet ofClassAtom ，参数为 rer。 - 令 B =
CompileToCharSet ofNonemptyClassRangesNoDash ，参数为 rer。 - 返回 A 与 B 的并集。
- 令 A =
CompileToCharSet of 第一个ClassAtom ，参数为 rer。 - 令 B =
CompileToCharSet of 第二个ClassAtom ，参数为 rer。 - 令 C =
CompileToCharSet ofClassContents ，参数为 rer。 - 令 D =
CharacterRange (A, B)。 - 返回 D 与 C 的并集。
- 令 A =
CompileToCharSet ofClassAtomNoDash ，参数为 rer。 - 令 B =
CompileToCharSet ofNonemptyClassRangesNoDash ，参数为 rer。 - 返回 A 与 B 的并集。
- 令 A =
CompileToCharSet ofClassAtomNoDash ，参数为 rer。 - 令 B =
CompileToCharSet ofClassAtom ，参数为 rer。 - 令 C =
CompileToCharSet ofClassContents ，参数为 rer。 - 令 D =
CharacterRange (A, B)。 - 返回 D 与 C 的并集。
即使忽略大小写，区间两端字符的大小写在区间确定时依然重要。例如 /[E-F]/i 只匹配 E,
F, e, f，而 /[E-f]/i 匹配 Basic
Latin 字母及 [, \, ], ^,
_, `。
- 可被当作字面量或区间。若在
- 返回仅包含字符
-U+002D (HYPHEN-MINUS) 的CharSet 。
- 返回仅包含
SourceCharacter 匹配字符的CharSet 。
- 令 cv 为本
ClassEscape 的CharacterValue 。 - 令 c 为字符值为 cv 的字符。
- 返回仅包含字符 c 的
CharSet 。
- 返回包含字符
0到9的十元素CharSet 。
- 令 S 为
CharacterClassEscape :: d CharSet 。 - 返回
CharacterComplement (rer, S)。
- 返回包含
WhiteSpace 或LineTerminator 产生式右侧所有码点的CharSet 。
- 令 S 为
CharacterClassEscape :: s CharSet 。 - 返回
CharacterComplement (rer, S)。
- 返回
MaybeSimpleCaseFolding (rer,WordCharacters (rer))。
- 令 S 为
CharacterClassEscape :: w CharSet 。 - 返回
CharacterComplement (rer, S)。
- 返回
CompileToCharSet ofUnicodePropertyValueExpression ，参数为 rer。
- 令 S 为
CompileToCharSet ofUnicodePropertyValueExpression ，参数为 rer。 断言 ：S 仅包含单一码点。- 返回
CharacterComplement (rer, S)。
- 令 ps 为
source text matched by UnicodePropertyName 。 - 令 p 为
UnicodeMatchProperty (rer, ps)。 断言 ：p 是表 69 “Property name and aliases” 列中列出的 Unicode属性名 或属性别名。- 令 vs 为
source text matched by UnicodePropertyValue 。 - 令 v 为
UnicodeMatchPropertyValue (p, vs)。 - 令 A 为包含所有在字符数据库定义中具有属性 p 且值为 v 的 Unicode 码点的
CharSet 。 - 返回
MaybeSimpleCaseFolding (rer, A)。
- 令 s 为
source text matched by LoneUnicodePropertyNameOrValue 。 - 如果
UnicodeMatchPropertyValue (General_Category, s) 是PropertyValueAliases.txt中 General_Category (gc) 属性的 Unicode 属性值或属性值别名，则： - 返回包含所有字符数据库定义中属性 “General_Category” 值为 s 的 Unicode 码点的
CharSet 。 - 令 p 为
UnicodeMatchProperty (rer, s)。 断言 ：p 是表 70 “Property name and aliases” 列中列出的二值 Unicode 属性或二值属性别名，或表 71 “Property name” 列中列出的字符串的二值 Unicode 属性。- 令 A 为包含所有字符数据库定义中属性 p 值为 “True” 的 CharSetElements 的
CharSet 。 - 返回
MaybeSimpleCaseFolding (rer, A)。
- 令 A 为
CompileToCharSet ofClassSetRange ，参数为 rer。 - 如果
ClassUnion 存在，则： - 令 B 为
CompileToCharSet ofClassUnion ，参数为 rer。 - 返回
CharSets A 与 B 的并集。 - 返回 A。
- 令 A 为
CompileToCharSet ofClassSetOperand ，参数为 rer。 - 如果
ClassUnion 存在，则： - 令 B 为
CompileToCharSet ofClassUnion ，参数为 rer。 - 返回
CharSets A 与 B 的并集。 - 返回 A。
- 令 A 为
CompileToCharSet of 第一个ClassSetOperand ，参数为 rer。 - 令 B 为
CompileToCharSet of 第二个ClassSetOperand ，参数为 rer。 - 返回
CharSets A 与 B 的交集。
- 令 A 为
CompileToCharSet ofClassIntersection ，参数为 rer。 - 令 B 为
CompileToCharSet ofClassSetOperand ，参数为 rer。 - 返回
CharSets A 与 B 的交集。
- 令 A 为第一个
CompileToCharSet ofClassSetOperand ，参数为 rer。 - 令 B 为第二个
CompileToCharSet ofClassSetOperand ，参数为 rer。 - 返回包含所有属于 A 但不属于 B 的 CharSetElements 的
CharSet 。
- 令 A 为
CompileToCharSet ofClassSubtraction ，参数为 rer。 - 令 B 为
CompileToCharSet ofClassSetOperand ，参数为 rer。 - 返回包含所有属于 A 但不属于 B 的 CharSetElements 的
CharSet 。
- 令 A 为第一个
CompileToCharSet ofClassSetCharacter ，参数为 rer。 - 令 B 为第二个
CompileToCharSet ofClassSetCharacter ，参数为 rer。 - 返回
MaybeSimpleCaseFolding (rer,CharacterRange (A, B))。
结果通常包含两个或更多区间。当 UnicodeSets 为
- 令 A 为
CompileToCharSet ofClassSetCharacter ，参数为 rer。 - 返回
MaybeSimpleCaseFolding (rer, A)。
- 令 A 为
CompileToCharSet ofClassStringDisjunction ，参数为 rer。 - 返回
MaybeSimpleCaseFolding (rer, A)。
- 返回
CompileToCharSet ofNestedClass ，参数为 rer。
- 返回
CompileToCharSet ofClassContents ，参数为 rer。
- 令 A 为
CompileToCharSet ofClassContents ，参数为 rer。 - 返回
CharacterComplement (rer, A)。
- 返回
CompileToCharSet ofCharacterClassEscape ，参数为 rer。
- 返回
CompileToCharSet ofClassStringDisjunctionContents ，参数为 rer。
- 令 s 为
CompileClassSetString ofClassString ，参数为 rer。 - 返回仅包含字符串 s 的
CharSet 。
- 令 s 为
CompileClassSetString ofClassString ，参数为 rer。 - 令 A 为仅包含字符串 s 的
CharSet 。 - 令 B 为
CompileToCharSet ofClassStringDisjunctionContents ，参数为 rer。 - 返回
CharSets A 与 B 的并集。
- 令 cv 为本
ClassSetCharacter 的CharacterValue 。 - 令 c 为字符值为 cv 的字符。
- 返回仅包含字符 c 的
CharSet 。
- 返回仅包含字符 U+0008 (BACKSPACE) 的
CharSet 。
22.2.2.9.1 CharacterRange (A, B)
抽象操作 CharacterRange 接收参数 A（
22.2.2.9.2 HasEitherUnicodeFlag (rer)
抽象操作 HasEitherUnicodeFlag 接收参数 rer（
- 如果 rer.[[Unicode]] 为
true 或 rer.[[UnicodeSets]] 为true ，则： - 返回
true 。 - 返回
false 。
22.2.2.9.3 WordCharacters (rer)
抽象操作 WordCharacters 接收参数 rer（\b、\B、\w、\W 所认为的“单词字符”。调用时执行如下步骤：
- 令 basicWordChars 为包含所有
ASCII 单词字符 的CharSet 。 - 令 extraWordChars 为包含所有字符 c 的
CharSet ，其中 c 不在 basicWordChars 内，但Canonicalize (rer, c) 在 basicWordChars 内。 断言 ：除非HasEitherUnicodeFlag (rer) 为true 且 rer.[[IgnoreCase]] 为true ，否则 extraWordChars 为空。- 返回 basicWordChars 与 extraWordChars 的并集。
22.2.2.9.4 AllCharacters (rer)
抽象操作 AllCharacters 接收参数 rer（
22.2.2.9.5 MaybeSimpleCaseFolding (rer, A)
抽象操作 MaybeSimpleCaseFolding 接收参数 rer（
- 如果 rer.[[UnicodeSets]] 为
false 或 rer.[[IgnoreCase]] 为false ，返回 A。 - 令 B 为一个新的空
CharSet 。 - 对 A 的每一个
CharSetElement s，执行： - 令 t 为空字符序列。
- 对 s 中每一个码点 cp，执行：
- 将
scf (cp) 附加到 t。 - 将 t 添加到 B。
- 返回 B。
22.2.2.9.6 CharacterComplement (rer, S)
抽象操作 CharacterComplement 接收参数 rer（
- 令 A =
AllCharacters (rer)。 - 返回包含所有属于 A 但不属于 S 的 CharSetElements 的
CharSet 。
22.2.2.9.7 UnicodeMatchProperty (rer, p)
抽象操作 UnicodeMatchProperty 接收参数 rer（
实现必须支持
例如，Script_Extensions（scx（属性别名）有效，但 script_extensions 或 Scx 无效。
这些属性集合是 UTS18 RL1.2 要求的超集。
这些表中的拼写（包括大小写）与 Unicode Character Database 文件 PropertyAliases.txt
保持一致。该文件中的拼写是 保证稳定的。
|
|
规范 |
|---|---|
General_Category |
General_Category
|
gc |
|
Script |
Script
|
sc |
|
Script_Extensions |
Script_Extensions
|
scx |
|
|
规范 |
|---|---|
ASCII |
ASCII
|
ASCII_Hex_Digit |
ASCII_Hex_Digit
|
AHex |
|
Alphabetic |
Alphabetic
|
Alpha |
|
Any |
Any
|
Assigned |
Assigned
|
Bidi_Control |
Bidi_Control
|
Bidi_C |
|
Bidi_Mirrored |
Bidi_Mirrored
|
Bidi_M |
|
Case_Ignorable |
Case_Ignorable
|
CI |
|
Cased |
Cased
|
Changes_When_Casefolded |
Changes_When_Casefolded
|
CWCF |
|
Changes_When_Casemapped |
Changes_When_Casemapped
|
CWCM |
|
Changes_When_Lowercased |
Changes_When_Lowercased
|
CWL |
|
Changes_When_NFKC_Casefolded |
Changes_When_NFKC_Casefolded
|
CWKCF |
|
Changes_When_Titlecased |
Changes_When_Titlecased
|
CWT |
|
Changes_When_Uppercased |
Changes_When_Uppercased
|
CWU |
|
Dash |
Dash
|
Default_Ignorable_Code_Point |
Default_Ignorable_Code_Point
|
DI |
|
Deprecated |
Deprecated
|
Dep |
|
Diacritic |
Diacritic
|
Dia |
|
Emoji |
Emoji
|
Emoji_Component |
Emoji_Component
|
EComp |
|
Emoji_Modifier |
Emoji_Modifier
|
EMod |
|
Emoji_Modifier_Base |
Emoji_Modifier_Base
|
EBase |
|
Emoji_Presentation |
Emoji_Presentation
|
EPres |
|
Extended_Pictographic |
Extended_Pictographic
|
ExtPict |
|
Extender |
Extender
|
Ext |
|
Grapheme_Base |
Grapheme_Base
|
Gr_Base |
|
Grapheme_Extend |
Grapheme_Extend
|
Gr_Ext |
|
Hex_Digit |
Hex_Digit
|
Hex |
|
IDS_Binary_Operator |
IDS_Binary_Operator
|
IDSB |
|
IDS_Trinary_Operator |
IDS_Trinary_Operator
|
IDST |
|
ID_Continue |
ID_Continue
|
IDC |
|
ID_Start |
ID_Start
|
IDS |
|
Ideographic |
Ideographic
|
Ideo |
|
Join_Control |
Join_Control
|
Join_C |
|
Logical_Order_Exception |
Logical_Order_Exception
|
LOE |
|
Lowercase |
Lowercase
|
Lower |
|
Math |
Math
|
Noncharacter_Code_Point |
Noncharacter_Code_Point
|
NChar |
|
Pattern_Syntax |
Pattern_Syntax
|
Pat_Syn |
|
Pattern_White_Space |
Pattern_White_Space
|
Pat_WS |
|
Quotation_Mark |
Quotation_Mark
|
QMark |
|
Radical |
Radical
|
Regional_Indicator |
Regional_Indicator
|
RI |
|
Sentence_Terminal |
Sentence_Terminal
|
STerm |
|
Soft_Dotted |
Soft_Dotted
|
SD |
|
Terminal_Punctuation |
Terminal_Punctuation
|
Term |
|
Unified_Ideograph |
Unified_Ideograph
|
UIdeo |
|
Uppercase |
Uppercase
|
Upper |
|
Variation_Selector |
Variation_Selector
|
VS |
|
White_Space |
White_Space
|
space |
|
XID_Continue |
XID_Continue
|
XIDC |
|
XID_Start |
XID_Start
|
XIDS |
|
|
|---|
Basic_Emoji（基础表情符号） |
Emoji_Keycap_Sequence（表情符号按键序列） |
RGI_Emoji_Modifier_Sequence（RGI表情符号修饰符序列） |
RGI_Emoji_Flag_Sequence（RGI表情符号旗帜序列） |
RGI_Emoji_Tag_Sequence（RGI表情符号标签序列） |
RGI_Emoji_ZWJ_Sequence（RGI表情符号ZWJ序列） |
RGI_Emoji（RGI表情符号） |
22.2.2.9.8 UnicodeMatchPropertyValue (p, v)
抽象操作 UnicodeMatchPropertyValue 接收参数 p（
实现必须支持 PropertyValueAliases.txt
文件中列出的 Unicode 属性值和属性值别名。为保证互操作性，实现不得支持其他属性值或属性值别名。
例如，Xpeo 和 Old_Persian 是有效的
Script_Extensions 属性值，但 xpeo 和
Old Persian 无效。
此算法不同于 UAX44
中列出的符号值匹配规则：不会忽略大小写、Is 前缀。
22.2.2.10 运行时语义：CompileClassSetString
- 返回空的字符序列。
- 返回
CompileClassSetString ofNonEmptyClassString ，参数为 rer。
- 令 cs 为
CompileToCharSet ofClassSetCharacter ，参数为 rer。 - 令 s1 为 cs 的唯一
CharSetElement 的字符序列。 - 如果
NonEmptyClassString 存在，则： - 令 s2 为
CompileClassSetString ofNonEmptyClassString ，参数为 rer。 - 返回 s1 和 s2 的拼接。
- 返回 s1。
22.2.3 正则表达式创建的抽象操作
22.2.3.1 RegExpCreate ( P, F )
抽象操作 RegExpCreate 接收参数 P（一个
- 令 obj 为 !
RegExpAlloc (%RegExp% )。 - 返回 ?
RegExpInitialize (obj, P, F)。
22.2.3.2 RegExpAlloc ( newTarget )
抽象操作 RegExpAlloc 接收参数 newTarget（
- 令 obj 为 ?
OrdinaryCreateFromConstructor (newTarget,"%RegExp.prototype%" , « [[OriginalSource]], [[OriginalFlags]], [[RegExpRecord]], [[RegExpMatcher]] »)。 - 执行 !
DefinePropertyOrThrow (obj,"lastIndex" , PropertyDescriptor { [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 obj。
22.2.3.3 RegExpInitialize ( obj, pattern, flags )
抽象操作 RegExpInitialize 接收参数 obj（对象）、pattern（
- 如果 pattern 是
undefined ，令 P 为空字符串。 - 否则，令 P 为 ?
ToString (pattern)。 - 如果 flags 是
undefined ，令 F 为空字符串。 - 否则，令 F 为 ?
ToString (flags)。 - 如果 F 包含除
"d" 、"g" 、"i" 、"m" 、"s" 、"u" 、"v" 、"y" 以外的任何代码单元，或 F 中有任何代码单元出现多次，则抛出SyntaxError 异常。 - 如果 F 包含
"i" ，令 i =true ；否则 i =false 。 - 如果 F 包含
"m" ，令 m =true ；否则 m =false 。 - 如果 F 包含
"s" ，令 s =true ；否则 s =false 。 - 如果 F 包含
"u" ，令 u =true ；否则 u =false 。 - 如果 F 包含
"v" ，令 v =true ；否则 v =false 。 - 如果 u 为
true 或 v 为true ，则- 令 patternText =
StringToCodePoints (P)。
- 令 patternText =
- 否则：
- 令 patternText 为将 P 的每个 16 位元素按 Unicode BMP 码点解释的结果。不会对这些元素做 UTF-16 解码。
- 令 parseResult =
ParsePattern (patternText, u, v)。 - 如果 parseResult 是一个非空的
List ，且包含SyntaxError 对象，则抛出SyntaxError 异常。 断言 ：parseResult 是一个Pattern 解析节点 。- 设置 obj.[[OriginalSource]] = P。
- 设置 obj.[[OriginalFlags]] = F。
- 令 capturingGroupsCount =
CountLeftCapturingParensWithin (parseResult)。 - 令 rer 为
RegExp Record { [[IgnoreCase]]: i, [[Multiline]]: m, [[DotAll]]: s, [[Unicode]]: u, [[UnicodeSets]]: v, [[CapturingGroupsCount]]: capturingGroupsCount }。 - 设置 obj.[[RegExpRecord]] = rer。
- 设置 obj.[[RegExpMatcher]] =
CompilePattern of parseResult，参数为 rer。 - 执行 ?
Set (obj,"lastIndex" ,+0 𝔽,true )。 - 返回 obj。
22.2.3.4 静态语义：ParsePattern (patternText, u, v)
抽象操作 ParsePattern 接收参数
patternText（Unicode码点序列）、u（布尔值）、v（布尔值），返回一个
本节在
调用时执行如下步骤：
- 如果 v 为
true 且 u 为true ，- 令 parseResult 为包含一个或多个
SyntaxError 对象的List 。
- 令 parseResult 为包含一个或多个
- 否则，如果 v 为
true ， - 否则，如果 u 为
true ， - 否则：
- 返回 parseResult。
22.2.4 RegExp 构造函数
RegExp
- 即 %RegExp%。
- 是
全局对象 的"RegExp" 属性的初始值。 - 作为
构造函数 调用时，会创建并初始化一个新的 RegExp 对象。 - 当作普通函数而非
构造函数 调用时，返回一个新的 RegExp 对象，或者如果唯一参数本身就是 RegExp 对象，则返回该参数本身。 - 可以作为类定义的
extends子句的值。子类构造函数 如果要继承指定的 RegExp 行为，必须包含对 RegExp构造函数 的super调用，以便用必要的内部插槽来创建并初始化子类实例。
22.2.4.1 RegExp ( pattern, flags )
该函数被调用时执行以下步骤：
- 令 patternIsRegExp 为 ?
IsRegExp (pattern)。 - 如果 NewTarget 是
undefined ，则 - 否则，
- 令 newTarget 为 NewTarget。
- 如果 pattern
是一个对象 且 pattern 有 [[RegExpMatcher]] 内部插槽，则- 令 P 为 pattern.[[OriginalSource]]。
- 如果 flags 是
undefined ，令 F 为 pattern.[[OriginalFlags]]。 - 否则，令 F 为 flags。
- 否则如果 patternIsRegExp 是
true ，则 - 否则，
- 令 P 为 pattern。
- 令 F 为 flags。
- 令 O 为 ?
RegExpAlloc (newTarget)。 - 返回 ?
RegExpInitialize (O, P, F)。
如果 pattern 是通过
22.2.5 RegExp 构造函数的属性
RegExp
- 拥有内部插槽 [[Prototype]]，其值为
%Function.prototype% 。 - 拥有如下属性：
22.2.5.1 RegExp.escape ( S )
该函数返回 S 的一个副本，其中正则表达式
调用时执行以下步骤：
- 如果 S
不是字符串 ，抛出TypeError 异常。 - 令 escaped 为空字符串。
- 令 cpList 为
StringToCodePoints (S)。 - 对于 cpList 中的每个码点 cp，执行
- 如果 escaped 为空字符串，且 cp 匹配
十进制数字 或ASCII 字母 ， 则- 注：转义首位数字可保证输出对应的模式文本在 \0 字符转义或
十进制转义 （如 \1）后仍能匹配 S，不会被解释为前一转义序列的扩展。首位 ASCII 字母的转义同理，适用于 \c 后的情况。 - 令 numericValue 为 cp 的数值。
- 令 hex 为
Number::toString (𝔽 (numericValue), 16)。 断言 ：hex 长度为 2。- 设置 escaped 为字符串拼接 0x005C（反斜杠）、"x" 及 hex。
- 注：转义首位数字可保证输出对应的模式文本在 \0 字符转义或
- 否则，
- 设置 escaped 为 escaped 与
EncodeForRegExpEscape (cp) 的字符串拼接。
- 设置 escaped 为 escaped 与
- 如果 escaped 为空字符串，且 cp 匹配
- 返回 escaped。
虽然名字相似，RegExp.escape 并不执行类似操作。前者用于将模式转义为字符串表示，后者用于将字符串转义为模式内部使用。
22.2.5.1.1 EncodeForRegExpEscape ( cp )
抽象操作 EncodeForRegExpEscape 接收参数 cp（码点），返回一个字符串。返回值即为匹配 cp 的模式
- 如果 cp 匹配
SyntaxCharacter 或等于 U+002F（/），则- 返回 0x005C（反斜杠）与
UTF16EncodeCodePoint (cp) 的字符串拼接。
- 返回 0x005C（反斜杠）与
- 否则，如果 cp 在
表 67 的“Code Point”列中，则- 返回 0x005C（反斜杠）与该行“ControlEscape”列字符串的字符串拼接。
- 令 otherPunctuators 为字符串 ",-=<>#&!%:;@~'`" 与 0x0022（引号）。
- 令 toEscape 为
StringToCodePoints (otherPunctuators)。 - 如果 toEscape 包含 cp，或 cp 匹配
WhiteSpace 、LineTerminator ，或 cp 与前导代理项 或尾随代理项 数值相同，则- 令 cpNum 为 cp 的数值。
- 如果 cpNum ≤ 0xFF，则
- 令 hex 为
Number::toString (𝔽 (cpNum), 16)。 - 返回 0x005C（反斜杠）、"x" 及
StringPad (hex, 2, "0",start ) 的字符串拼接。
- 令 hex 为
- 令 escaped 为空字符串。
- 令 codeUnits 为
UTF16EncodeCodePoint (cp)。 - 对于 codeUnits 中每个 code unit cu，执行
- 设置 escaped 为 escaped 与
UnicodeEscape (cu) 的字符串拼接。
- 设置 escaped 为 escaped 与
- 返回 escaped。
- 返回
UTF16EncodeCodePoint (cp)。
22.2.5.2 RegExp.prototype
RegExp.prototype 的初始值为
该属性具有属性：{ [[Writable]]:
22.2.5.3 get RegExp [ %Symbol.species% ]
RegExp[%Symbol.species%] 是一个
- 返回
this 值。
此函数的
RegExp 原型方法通常使用其
22.2.6 RegExp 原型对象的属性
RegExp 原型对象：
- 即 %RegExp.prototype%。
- 是一个
普通对象 。 - 不是 RegExp 实例，不具有 [[RegExpMatcher]] 内部插槽，也没有 RegExp 实例对象的其他内部插槽。
- 拥有 [[Prototype]] 内部插槽，其值为
%Object.prototype% 。
RegExp 原型对象自身没有
22.2.6.1 RegExp.prototype.constructor
RegExp.prototype.constructor 的初始值为
22.2.6.2 RegExp.prototype.exec ( string )
该方法在 string 中搜索正则表达式的匹配项，并返回包含匹配结果的数组，若 string 不匹配则返回
调用时执行如下步骤：
- 令 R 为
this 值。 - 执行 ?
RequireInternalSlot (R, [[RegExpMatcher]])。 - 令 S 为 ?
ToString (string)。 - 返回 ?
RegExpBuiltinExec (R, S)。
22.2.6.3 get RegExp.prototype.dotAll
RegExp.prototype.dotAll 是一个
- 令 R 为
this 值。 - 令 cu 为码元 0x0073（小写字母 s）。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.4 get RegExp.prototype.flags
RegExp.prototype.flags 是一个
- 令 R 为
this 值。 - 如果 R
不是对象 ，抛出TypeError 异常。 - 令 codeUnits 为一个新的空
List 。 - 令 hasIndices 为
ToBoolean (?Get (R,"hasIndices" ))。 - 如果 hasIndices 为
true ，将码元 0x0064（小写字母 d）添加到 codeUnits。 - 令 global 为
ToBoolean (?Get (R,"global" ))。 - 如果 global 为
true ，将码元 0x0067（g）添加到 codeUnits。 - 令 ignoreCase 为
ToBoolean (?Get (R,"ignoreCase" ))。 - 如果 ignoreCase 为
true ，将码元 0x0069（i）添加到 codeUnits。 - 令 multiline 为
ToBoolean (?Get (R,"multiline" ))。 - 如果 multiline 为
true ，将码元 0x006D（m）添加到 codeUnits。 - 令 dotAll 为
ToBoolean (?Get (R,"dotAll" ))。 - 如果 dotAll 为
true ，将码元 0x0073（s）添加到 codeUnits。 - 令 unicode 为
ToBoolean (?Get (R,"unicode" ))。 - 如果 unicode 为
true ，将码元 0x0075（u）添加到 codeUnits。 - 令 unicodeSets 为
ToBoolean (?Get (R,"unicodeSets" ))。 - 如果 unicodeSets 为
true ，将码元 0x0076（v）添加到 codeUnits。 - 令 sticky 为
ToBoolean (?Get (R,"sticky" ))。 - 如果 sticky 为
true ，将码元 0x0079（y）添加到 codeUnits。 - 返回由
List codeUnits 组成的字符串；若 codeUnits 为空，则返回空字符串。
22.2.6.4.1 RegExpHasFlag ( R, codeUnit )
抽象操作 RegExpHasFlag 接收参数 R（
- 如果 R
不是对象 ，抛出TypeError 异常。 - 如果 R 没有 [[OriginalFlags]] 内部插槽，则
- 如果
SameValue (R,%RegExp.prototype% ) 为true ，返回undefined 。 - 否则，抛出
TypeError 异常。
- 如果
- 令 flags 为 R.[[OriginalFlags]]。
- 如果 flags 包含 codeUnit，返回
true 。 - 返回
false 。
22.2.6.5 get RegExp.prototype.global
RegExp.prototype.global 是一个
- 令 R 为
this 值。 - 令 cu 为码元 0x0067（g）。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.6 get RegExp.prototype.hasIndices
RegExp.prototype.hasIndices 是一个
- 令 R 为
this 值。 - 令 cu 为码元 0x0064（d）。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.7 get RegExp.prototype.ignoreCase
RegExp.prototype.ignoreCase 是一个
- 令 R 为
this 值。 - 令 cu 为码元 0x0069（i）。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.8 RegExp.prototype [ %Symbol.match% ] ( string )
该方法调用时执行如下步骤：
- 令 rx 为
this 值。 - 如果 rx
不是对象 ，抛出TypeError 异常。 - 令 S 为 ?
ToString (string)。 - 令 flags 为 ?
ToString (?Get (rx,"flags" ))。 - 如果 flags 不包含
"g" ，则- 返回 ?
RegExpExec (rx, S)。
- 返回 ?
- 否则，
- 如果 flags 包含
"u" 或 flags 包含"v" ，令 fullUnicode 为true 。否则，令 fullUnicode 为false 。 - 执行 ?
Set (rx,"lastIndex" ,+0 𝔽,true )。 - 令 A 为 !
ArrayCreate (0)。 - 令 n 为 0。
- 重复，
- 令 result 为 ?
RegExpExec (rx, S)。 - 如果 result 为
null ，则- 如果 n = 0，返回
null 。 - 返回 A。
- 如果 n = 0，返回
- 否则，
- 令 matchStr 为 ?
ToString (?Get (result,"0" ))。 - 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), matchStr)。 - 如果 matchStr 是空字符串，则
- 设置 n 为 n + 1。
- 令 matchStr 为 ?
- 令 result 为 ?
- 如果 flags 包含
该方法的
22.2.6.9 RegExp.prototype [ %Symbol.matchAll% ] ( string )
该方法调用时执行如下步骤：
- 令 R 为
this 值。 - 如果 R
不是对象 ，抛出TypeError 异常。 - 令 S 为 ?
ToString (string)。 - 令 C 为 ?
SpeciesConstructor (R,%RegExp% )。 - 令 flags 为 ?
ToString (?Get (R,"flags" ))。 - 令 matcher 为 ?
Construct (C, « R, flags »)。 - 令 lastIndex 为 ?
ToLength (?Get (R,"lastIndex" ))。 - 执行 ?
Set (matcher,"lastIndex" , lastIndex,true )。 - 如果 flags 包含
"g" ，令 global 为true 。 - 否则，令 global 为
false 。 - 如果 flags 包含
"u" 或 flags 包含"v" ，令 fullUnicode 为true 。 - 否则，令 fullUnicode 为
false 。 - 返回
CreateRegExpStringIterator (matcher, S, global, fullUnicode)。
该方法的
22.2.6.10 get RegExp.prototype.multiline
RegExp.prototype.multiline 是一个
- 令 R 为
this 值。 - 令 cu 为码元 0x006D（m）。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.11 RegExp.prototype [ %Symbol.replace% ] ( string, replaceValue )
该方法调用时执行如下步骤：
- 令 rx 为
this 值。 - 如果 rx
不是对象 ，抛出TypeError 异常。 - 令 S 为 ?
ToString (string)。 - 令 lengthS 为 S 的长度。
- 令 functionalReplace 为
IsCallable (replaceValue)。 - 如果 functionalReplace 为
false ，则- 设置 replaceValue 为 ?
ToString (replaceValue)。
- 设置 replaceValue 为 ?
- 令 flags 为 ?
ToString (?Get (rx,"flags" ))。 - 如果 flags 包含
"g" ，令 global 为true ；否则 global 为false 。 - 如果 global 为
true ，则- 执行 ?
Set (rx,"lastIndex" ,+0 𝔽,true )。
- 执行 ?
- 令 results 为一个新的空
List 。 - 令 done 为
false 。 - 重复，直到 done 为
false ，- 令 result 为 ?
RegExpExec (rx, S)。 - 如果 result 为
null ，则- 设置 done 为
true 。
- 设置 done 为
- 否则，
- 令 result 为 ?
- 令 accumulatedResult 为空字符串。
- 令 nextSourcePosition 为 0。
- 对于 results 中的每个元素 result，执行
- 令 resultLength 为 ?
LengthOfArrayLike (result)。 - 令 nCaptures 为
max (resultLength - 1, 0)。 - 令 matched 为 ?
ToString (?Get (result,"0" ))。 - 令 matchLength 为 matched 的长度。
- 令 position 为 ?
ToIntegerOrInfinity (?Get (result,"index" ))。 - 将 position 限制在 0 到 lengthS 之间。
- 令 captures 为一个新的空
List 。 - 令 n 为 1。
- 重复，直到 n ≤ nCaptures，
- 令 namedCaptures 为 ?
Get (result,"groups" )。 - 如果 functionalReplace 为
true ，则 - 否则，
- 如果 namedCaptures 不为
undefined ，则- 设置 namedCaptures 为 ?
ToObject (namedCaptures)。
- 设置 namedCaptures 为 ?
- 令 replacementString 为 ?
GetSubstitution (matched, S, position, captures, namedCaptures, replaceValue)。
- 如果 namedCaptures 不为
- 如果 position ≥ nextSourcePosition，则
- 注：position 通常不会倒退。如果发生，说明是行为异常的 RegExp 子类或通过副作用改变了 global 标志或 rx 的其它特性，此时对应替换会被忽略。
- 设置 accumulatedResult 为 accumulatedResult、S 的 nextSourcePosition 到 position 子串、和 replacementString 的字符串拼接。
- 设置 nextSourcePosition 为 position + matchLength。
- 令 resultLength 为 ?
- 如果 nextSourcePosition ≥ lengthS，返回 accumulatedResult。
- 返回 accumulatedResult 与 S 从 nextSourcePosition 开始的子串的字符串拼接。
该方法的
22.2.6.12 RegExp.prototype [ %Symbol.search% ] ( string )
该方法调用时执行如下步骤：
- 令 rx 为
this 值。 - 如果 rx
不是对象 ，抛出TypeError 异常。 - 令 S 为 ?
ToString (string)。 - 令 previousLastIndex 为 ?
Get (rx,"lastIndex" )。 - 如果 previousLastIndex 不为
+0 𝔽，则- 执行 ?
Set (rx,"lastIndex" ,+0 𝔽,true )。
- 执行 ?
- 令 result 为 ?
RegExpExec (rx, S)。 - 令 currentLastIndex 为 ?
Get (rx,"lastIndex" )。 - 如果
SameValue (currentLastIndex, previousLastIndex) 为false ，则- 执行 ?
Set (rx,"lastIndex" , previousLastIndex,true )。
- 执行 ?
- 如果 result 为
null ，返回-1 𝔽。 - 返回 ?
Get (result,"index" )。
该方法的
本 RegExp 对象的
22.2.6.13 get RegExp.prototype.source
RegExp.prototype.source 是一个
- 令 R 为
this 值。 - 如果 R
不是对象 ，抛出TypeError 异常。 - 如果 R 没有 [[OriginalSource]] 内部插槽，则
- 如果
SameValue (R,%RegExp.prototype% ) 为true ，返回"(?:)" 。 - 否则，抛出
TypeError 异常。
- 如果
断言 ：R 拥有 [[OriginalFlags]] 内部插槽。- 令 src 为 R.[[OriginalSource]]。
- 令 flags 为 R.[[OriginalFlags]]。
- 返回
EscapeRegExpPattern (src, flags)。
22.2.6.13.1 EscapeRegExpPattern ( P, F )
抽象操作 EscapeRegExpPattern 接收参数 P（字符串）和 F（字符串），返回一个字符串。调用时执行如下步骤：
- 如果 F 包含
"v" ，则- 令 patternSymbol 为
Pattern 。[+UnicodeMode, +UnicodeSetsMode]
- 令 patternSymbol 为
- 否则如果 F 包含
"u" ，则- 令 patternSymbol 为
Pattern 。[+UnicodeMode, ~UnicodeSetsMode]
- 令 patternSymbol 为
- 否则：
- 令 patternSymbol 为
Pattern 。[~UnicodeMode, ~UnicodeSetsMode]
- 令 patternSymbol 为
- 令 S 为形式为 patternSymbol 的字符串，其内容等价于将 P 按 UTF-16
编码的 Unicode 码点解释后得到的模式，并对部分码点按下述方式转义。S 可能与 P 相同，也可能不同；但对
S 作为 patternSymbol 求值所得的
抽象闭包 必须与构造对象的 [[RegExpMatcher]] 内部插槽给出的抽象闭包 行为一致。对同一 P 和 F 多次调用本操作，结果必须一致。 - pattern 中的
/及所有LineTerminator 码点须在 S 中转义，以确保字符串拼接 "/" 、S、"/" 和 F 可作为RegularExpressionLiteral 被解析，并与构造的正则表达式行为一致。如 P 为"/" ，则 S 可为"\/" 或"\u002F" ，但不能为"/" ，否则///后接 F 会被解析为单行注释 而不是正则表达式字面量 。若 P 为空字符串，则 S 可为"(?:)" 。 - 返回 S。
尽管名字类似，RegExp.escape 与 EscapeRegExpPattern
并不执行类似操作。前者用于将字符串转义为可在模式中使用的内容，后者用于将模式转义为可作为字符串表示。
22.2.6.14 RegExp.prototype [ %Symbol.split% ] ( string, limit )
该方法返回一个数组，数组中存储了将 string 转换为字符串后的子串。这些子串是通过从左到右搜索
/a*?/[Symbol.split]("ab")
的结果是 ["a", "b"]，而 /a*/[Symbol.split]("ab") 的结果是
["","b"]。）
如果 string 是（或转换为）空字符串，结果取决于正则表达式是否能匹配空字符串。如果能，结果数组无元素；否则，结果数组含一个元素，即空字符串。
如果正则表达式含有捕获括号，则每次 separator 匹配时，括号捕获的结果（包括
/<(\/)?([^<>]+)>/[Symbol.split]("A<B>bold</B>and<CODE>coded</CODE>")结果为数组
["A", undefined, "B", "bold", "/", "B", "and", undefined, "CODE", "coded", "/", "CODE", ""]如果 limit 不为
该方法调用时执行如下步骤：
- 令 rx 为
this 值。 - 如果 rx
不是对象 ，抛出TypeError 异常。 - 令 S 为 ?
ToString (string)。 - 令 C 为 ?
SpeciesConstructor (rx,%RegExp% )。 - 令 flags 为 ?
ToString (?Get (rx,"flags" ))。 - 如果 flags 包含
"u" 或 flags 包含"v" ，令 unicodeMatching 为true 。 - 否则，令 unicodeMatching 为
false 。 - 如果 flags 包含
"y" ，令 newFlags 为 flags。 - 否则，令 newFlags 为 flags 与
"y" 的字符串拼接。 - 令 splitter 为 ?
Construct (C, « rx, newFlags »)。 - 令 A 为 !
ArrayCreate (0)。 - 令 lengthA 为 0。
- 如果 limit 是
undefined ，令 lim 为 232 - 1；否则，令 lim 为ℝ (?ToUint32 (limit))。 - 如果 lim = 0，返回 A。
- 如果 S 是空字符串，则
- 令 z 为 ?
RegExpExec (splitter, S)。 - 如果 z 不为
null ，返回 A。 - 执行 !
CreateDataPropertyOrThrow (A,"0" , S)。 - 返回 A。
- 令 z 为 ?
- 令 size 为 S 的长度。
- 令 p 为 0。
- 令 q 为 p。
- 重复，直到 q < size，
- 执行 ?
Set (splitter,"lastIndex" ,𝔽 (q),true )。 - 令 z 为 ?
RegExpExec (splitter, S)。 - 如果 z 为
null ，则- 设置 q 为
AdvanceStringIndex (S, q, unicodeMatching)。
- 设置 q 为
- 否则，
- 令 e 为
ℝ (?ToLength (?Get (splitter,"lastIndex" )))。 - 将 e 限制为不大于 size。
- 如果 e = p，则
- 设置 q 为
AdvanceStringIndex (S, q, unicodeMatching)。
- 设置 q 为
- 否则，
- 令 T 为
substring of S 从 p 到 q。 - 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (lengthA)), T)。 - 设置 lengthA 为 lengthA + 1。
- 如果 lengthA = lim，返回 A。
- 设置 p 为 e。
- 令 numberOfCaptures 为 ?
LengthOfArrayLike (z)。 - 将 numberOfCaptures 限制为 numberOfCaptures - 1 与 0 之间的最大值。
- 令 i 为 1。
- 重复，直到 i ≤ numberOfCaptures，
- 设置 q 为 p。
- 令 T 为
- 令 e 为
- 执行 ?
- 令 T 为
substring of S 从 p 到 size。 - 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (lengthA)), T)。 - 返回 A。
该方法的
该方法会忽略本 RegExp 对象的
22.2.6.15 get RegExp.prototype.sticky
RegExp.prototype.sticky 是一个
- 令 R 为
this 值。 - 令 cu 为码元 0x0079（y）。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.16 RegExp.prototype.test ( S )
该方法调用时执行如下步骤：
- 令 R 为
this 值。 - 如果 R
不是对象 ，抛出TypeError 异常。 - 令 string 为 ?
ToString (S)。 - 令 match 为 ?
RegExpExec (R, string)。 - 如果 match 不为
null ，返回true ；否则返回false 。
22.2.6.17 RegExp.prototype.toString ( )
返回的字符串具有
22.2.6.18 get RegExp.prototype.unicode
RegExp.prototype.unicode 是一个
- 令 R 为
this 值。 - 令 cu 为码元 0x0075（u）。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.19 get RegExp.prototype.unicodeSets
RegExp.prototype.unicodeSets 是一个
- 令 R 为
this 值。 - 令 cu 为码元 0x0076（v）。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.7 正则匹配的抽象操作
22.2.7.1 RegExpExec ( R, S )
抽象操作 RegExpExec 接收参数 R（对象）和 S（字符串），返回
- 令 exec 为 ?
Get (R,"exec" )。 - 如果
IsCallable (exec) 为true ，则 - 执行 ?
RequireInternalSlot (R, [[RegExpMatcher]])。 - 返回 ?
RegExpBuiltinExec (R, S)。
如果未找到可调用的
22.2.7.2 RegExpBuiltinExec ( R, S )
抽象操作 RegExpBuiltinExec 接收参数 R（初始化后的 RegExp 实例）和 S（字符串），返回
- 令 length 为 S 的长度。
- 令 lastIndex 为
ℝ (?ToLength (?Get (R,"lastIndex" )))。 - 令 flags 为 R.[[OriginalFlags]]。
- 如果 flags 包含
"g" ，令 global 为true ；否则为false 。 - 如果 flags 包含
"y" ，令 sticky 为true ；否则为false 。 - 如果 flags 包含
"d" ，令 hasIndices 为true ；否则为false 。 - 如果 global 为
false 且 sticky 为false ，将 lastIndex 设为 0。 - 令 matcher 为 R.[[RegExpMatcher]]。
- 如果 flags 包含
"u" 或 flags 包含"v" ，令 fullUnicode 为true ；否则为false 。 - 令 matchSucceeded 为
false 。 - 如果 fullUnicode 为
true ，令 input 为StringToCodePoints (S)；否则，令 input 为包含 S 各码元的List 。 - 注：input 的每个元素都被视为一个字符。
- 重复，直到 matchSucceeded 为
false ，- 如果 lastIndex > length，则
- 如果 global 或 sticky 为
true ，则- 执行 ?
Set (R,"lastIndex" ,+0 𝔽,true )。
- 执行 ?
- 返回
null 。
- 如果 global 或 sticky 为
- 令 inputIndex 为 S 索引 lastIndex 处对应 input 的下标。
- 令 r 为 matcher(input, inputIndex)。
- 如果 r 为
failure ，则- 如果 sticky 为
true ，则- 执行 ?
Set (R,"lastIndex" ,+0 𝔽,true )。 - 返回
null 。
- 执行 ?
- 将 lastIndex 设为
AdvanceStringIndex (S, lastIndex, fullUnicode)。
- 如果 sticky 为
- 否则，
断言 ：r 是MatchState 。- 设置 matchSucceeded 为
true 。
- 如果 lastIndex > length，则
- 令 e 为 r.[[EndIndex]]。
- 如果 fullUnicode 为
true ，则将 e 设为GetStringIndex (S, e)。 - 如果 global 或 sticky 为
true ，则 - 令 n 为 r.[[Captures]] 的元素数。
断言 ：n = R.[[RegExpRecord]].[[CapturingGroupsCount]]。断言 ：n < 232 - 1。- 令 A 为 !
ArrayCreate (n + 1)。 断言 ：A 的"length" 数学值为 n + 1。- 执行 !
CreateDataPropertyOrThrow (A,"index" ,𝔽 (lastIndex))。 - 执行 !
CreateDataPropertyOrThrow (A,"input" , S)。 - 令 match 为
Match Record { [[StartIndex]]: lastIndex, [[EndIndex]]: e }。 - 令 indices 为一个新的空
List 。 - 令 groupNames 为一个新的空
List 。 - 将 match 添加到 indices。
- 令 matchedSubstr 为
GetMatchString (S, match)。 - 执行 !
CreateDataPropertyOrThrow (A,"0" , matchedSubstr)。 - 如果 R 包含
GroupName ，- 令 groups 为
OrdinaryObjectCreate (null )。 - 令 hasGroups 为
true 。
- 令 groups 为
- 否则，
- 令 groups 为
undefined 。 - 令 hasGroups 为
false 。
- 令 groups 为
- 执行 !
CreateDataPropertyOrThrow (A,"groups" , groups)。 - 令 matchedGroupNames 为一个新的空
List 。 - 对于所有 1 ≤ i ≤ n 的整数 i，升序执行
- 令 captureI 为 r.[[Captures]] 的第 i 个元素。
- 如果 captureI 为
undefined ，- 令 capturedValue 为
undefined 。 - 将
undefined 添加到 indices。
- 令 capturedValue 为
- 否则，
- 令 captureStart 为 captureI.[[StartIndex]]。
- 令 captureEnd 为 captureI.[[EndIndex]]。
- 如果 fullUnicode 为
true ，- 设置 captureStart 为
GetStringIndex (S, captureStart)。 - 设置 captureEnd 为
GetStringIndex (S, captureEnd)。
- 设置 captureStart 为
- 令 capture 为
Match Record { [[StartIndex]]: captureStart, [[EndIndex]]: captureEnd }。 - 令 capturedValue 为
GetMatchString (S, capture)。 - 将 capture 添加到 indices。
- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (i)), capturedValue)。 - 如果 R 的第 i 个捕获带有
GroupName ，- 令 s 为该
GroupName 的CapturingGroupName 。 - 如果 matchedGroupNames 包含 s，
断言 ：capturedValue 为undefined 。- 将
undefined 添加到 groupNames。
- 否则，
- 如果 capturedValue 不为
undefined ，将 s 添加到 matchedGroupNames。 - 注：如有多个同名分组，groups 可能已有属性 s。但因 groups 是普通对象，其属性均为可写数据属性，CreateDataPropertyOrThrow 调用必然成功。
- 执行 !
CreateDataPropertyOrThrow (groups, s, capturedValue)。 - 将 s 添加到 groupNames。
- 如果 capturedValue 不为
- 令 s 为该
- 否则，
- 将
undefined 添加到 groupNames。
- 将
- 如果 hasIndices 为
true ，- 令 indicesArray 为
MakeMatchIndicesIndexPairArray (S, indices, groupNames, hasGroups)。 - 执行 !
CreateDataPropertyOrThrow (A,"indices" , indicesArray)。
- 令 indicesArray 为
- 返回 A。
22.2.7.3 AdvanceStringIndex ( S, index, unicode )
抽象操作 AdvanceStringIndex 接收参数 S（字符串）、index（非负整数）、unicode（布尔值），返回一个整数。调用时执行如下步骤：
断言 ：index ≤ 253 - 1。- 如果 unicode 为
false ，返回 index + 1。 - 令 length 为 S 的长度。
- 如果 index + 1 ≥ length，返回 index + 1。
- 令 cp 为
CodePointAt (S, index)。 - 返回 index + cp.[[CodeUnitCount]]。
22.2.7.4 GetStringIndex ( S, codePointIndex )
抽象操作 GetStringIndex 接收参数 S（字符串）和 codePointIndex（非负整数），返回一个非负整数。它将
S 作为 UTF-16 编码码点序列，根据
- 如果 S 是空字符串，返回 0。
- 令 len 为 S 的长度。
- 令 codeUnitCount 为 0。
- 令 codePointCount 为 0。
- 重复，直到 codeUnitCount < len，
- 如果 codePointCount = codePointIndex，返回 codeUnitCount。
- 令 cp 为
CodePointAt (S, codeUnitCount)。 - 设置 codeUnitCount 为 codeUnitCount + cp.[[CodeUnitCount]]。
- 设置 codePointCount 为 codePointCount + 1。
- 返回 len。
22.2.7.5 匹配记录（Match Records）
匹配记录（Match Record） 是一种
匹配记录的字段列于
| 字段名 | 值 | 含义 |
|---|---|---|
| [[StartIndex]] | 非负 |
匹配开始（包含）的字符串起始码元数。 |
| [[EndIndex]] | 一个 |
匹配结束（不含）的字符串起始码元数。 |
22.2.7.6 GetMatchString ( S, match )
抽象操作 GetMatchString 接收参数 S（字符串）和 match（
22.2.7.7 GetMatchIndexPair ( S, match )
抽象操作 GetMatchIndexPair 接收参数 S（字符串）和 match（
断言 ：match.[[StartIndex]] ≤ match.[[EndIndex]] ≤ S 的长度。- 返回
CreateArrayFromList («𝔽 (match.[[StartIndex]]),𝔽 (match.[[EndIndex]])»)。
22.2.7.8 MakeMatchIndicesIndexPairArray ( S, indices, groupNames, hasGroups )
抽象操作 MakeMatchIndicesIndexPairArray 接收参数 S（字符串）、indices（
- 令 n 为 indices 的元素数。
断言 ：n < 232 - 1。断言 ：groupNames 有 n - 1 个元素。- 注：groupNames 列表中的元素与 indices 列表自 indices[1] 起一一对应。
- 令 A 为 !
ArrayCreate (n)。 - 如果 hasGroups 为
true ，- 令 groups 为
OrdinaryObjectCreate (null )。
- 令 groups 为
- 否则，
- 令 groups 为
undefined 。
- 令 groups 为
- 执行 !
CreateDataPropertyOrThrow (A,"groups" , groups)。 - 对于 0 ≤ i < n 的每个整数 i，升序执行
- 令 matchIndices 为 indices[i]。
- 如果 matchIndices 不为
undefined ，- 令 matchIndexPair 为
GetMatchIndexPair (S, matchIndices)。
- 令 matchIndexPair 为
- 否则，
- 令 matchIndexPair 为
undefined 。
- 令 matchIndexPair 为
- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (i)), matchIndexPair)。 - 如果 i > 0，
- 令 s 为 groupNames[i - 1]。
- 如果 s 不为
undefined ，断言 ：groups 不为undefined 。- 注：如有多个同名分组，groups 可能已经有 s 属性。因 groups 是普通对象，属性均为可写数据属性，CreateDataPropertyOrThrow 调用必然成功。
- 执行 !
CreateDataPropertyOrThrow (groups, s, matchIndexPair)。
- 返回 A。
22.2.8 RegExp 实例的属性
RegExp 实例是
在 ECMAScript 2015 之前，RegExp 实例被规范为拥有自身的数据属性 RegExp.prototype 的
RegExp 实例还具有以下属性：
22.2.8.1 lastIndex
22.2.9 RegExp 字符串迭代器对象
RegExp 字符串迭代器是用于表示对某个特定字符串实例对象、针对某个特定 RegExp 实例对象进行迭代的对象。RegExp
字符串迭代器对象没有具名的
22.2.9.1 CreateRegExpStringIterator ( R, S, global, fullUnicode )
抽象操作 CreateRegExpStringIterator 接收参数 R（对象）、S（字符串）、global（布尔值）、fullUnicode（布尔值），返回一个对象。调用时执行如下步骤：
- 令 iterator 为
OrdinaryObjectCreate (%RegExpStringIteratorPrototype% , « [[IteratingRegExp]], [[IteratedString]], [[Global]], [[Unicode]], [[Done]] »)。 - 设置 iterator.[[IteratingRegExp]] = R。
- 设置 iterator.[[IteratedString]] = S。
- 设置 iterator.[[Global]] = global。
- 设置 iterator.[[Unicode]] = fullUnicode。
- 设置 iterator.[[Done]] =
false 。 - 返回 iterator。
22.2.9.2 %RegExpStringIteratorPrototype% 对象
%RegExpStringIteratorPrototype% 对象：
- 拥有所有
RegExp 字符串迭代器对象 继承的属性。 - 是一个
普通对象 。 - 具有内部插槽 [[Prototype]]，其值为
%Iterator.prototype% 。 - 具有如下属性：
22.2.9.2.1 %RegExpStringIteratorPrototype%.next ( )
- 令 O 为
this 值。 - 如果 O
不是对象 ，抛出TypeError 异常。 - 如果 O 不具有
RegExp 字符串迭代器 对象实例的所有内部插槽（见22.2.9.3 ），抛出TypeError 异常。 - 如果 O.[[Done]] 为
true ，- 返回
CreateIteratorResultObject (undefined ,true )。
- 返回
- 令 R = O.[[IteratingRegExp]]。
- 令 S = O.[[IteratedString]]。
- 令 global = O.[[Global]]。
- 令 fullUnicode = O.[[Unicode]]。
- 令 match 为 ?
RegExpExec (R, S)。 - 如果 match 为
null ，- 设置 O.[[Done]] =
true 。 - 返回
CreateIteratorResultObject (undefined ,true )。
- 设置 O.[[Done]] =
- 如果 global 为
false ，- 设置 O.[[Done]] =
true 。 - 返回
CreateIteratorResultObject (match,false )。
- 设置 O.[[Done]] =
- 令 matchStr 为 ?
ToString (?Get (match,"0" ))。 - 如果 matchStr 是空字符串，
- 返回
CreateIteratorResultObject (match,false )。
22.2.9.2.2 %RegExpStringIteratorPrototype% [ %Symbol.toStringTag% ]
该属性具有属性 { [[Writable]]:
22.2.9.3 RegExp 字符串迭代器实例的属性
| 内部插槽 | 类型 | 描述 |
|---|---|---|
| [[IteratingRegExp]] | 对象 | 用于迭代的正则表达式。 |
| [[IteratedString]] | 字符串 | 被迭代的字符串值。 |
| [[Global]] | 布尔值 | 指示 [[IteratingRegExp]] 是否为全局。 |
| [[Unicode]] | 布尔值 | 指示 [[IteratingRegExp]] 是否为 Unicode 模式。 |
| [[Done]] | 布尔值 | 指示迭代是否已完成。 |
23 索引集合
23.1 数组对象
数组是
23.1.1 Array 构造函数
Array
- 即 %Array%。
- 是
全局对象 的"Array" 属性的初始值。 - 作为
构造函数 调用时，会创建并初始化一个新的数组。 - 作为普通函数而不是
构造函数 调用时，也会创建并初始化一个新的数组。因此，函数调用Array(…)等价于使用相同参数的对象创建表达式new Array(…)。 - 是一个其行为根据参数数量和类型而异的函数。
- 可用作类定义中
extends子句的值。打算继承数组特殊行为的子类构造函数 ，必须包含对 Array构造函数 的super调用，以初始化作为数组特殊对象 的子类实例。然而，大多数Array.prototype方法是泛型方法，不依赖于其this 值为数组特殊对象 。
23.1.1.1 Array ( ...values )
当调用该函数时，执行以下步骤：
- 如果 NewTarget 为
undefined ，则令 newTarget 为活动函数对象 ；否则令 newTarget 为 NewTarget。 - 令 proto 为 ?
GetPrototypeFromConstructor (newTarget,"%Array.prototype%" )。 - 令 numberOfArgs 为 values 中元素的数量。
- 如果 numberOfArgs = 0，则
- 返回 !
ArrayCreate (0, proto)。
- 返回 !
- 否则如果 numberOfArgs = 1，则
- 令 len 为 values[0]。
- 令 array 为 !
ArrayCreate (0, proto)。 - 如果 len
不是数字类型 ，则- 执行 !
CreateDataPropertyOrThrow (array,"0" , len)。 - 令 intLen 为
1 𝔽。
- 执行 !
- 否则，
- 令 intLen 为 !
ToUint32 (len)。 - 如果
SameValueZero (intLen, len) 为false ，则抛出RangeError 异常。
- 令 intLen 为 !
- 执行 !
Set (array,"length" , intLen,true )。 - 返回 array。
- 否则，
断言 ：numberOfArgs ≥ 2。- 令 array 为 ?
ArrayCreate (numberOfArgs, proto)。 - 令 k 为 0。
- 重复，直到 k < numberOfArgs，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 itemK 为 values[k]。
- 执行 !
CreateDataPropertyOrThrow (array, Pk, itemK)。 - 令 k 为 k + 1。
- 令 Pk 为 !
断言 ：array 的"length" 属性的数学值为 numberOfArgs。- 返回 array。
23.1.2 Array 构造函数的属性
Array
- 具有一个名为 [[Prototype]] 的内部槽，其值为
%Function.prototype% 。 - 具有一个值为
1 𝔽 的"length" 属性。 - 具有以下属性：
23.1.2.1 Array.from ( items [ , mapper [ , thisArg ] ] )
当调用该方法时，执行以下步骤：
- 令 C 为
this 值。 - 如果 mapper 为
undefined ，则- 令 mapping 为
false 。
- 令 mapping 为
- 否则，
- 如果
IsCallable (mapper) 为false ，则抛出TypeError 异常。 - 令 mapping 为
true 。
- 如果
- 令 usingIterator 为 ?
GetMethod (items,%Symbol.iterator% )。 - 如果 usingIterator 不为
undefined ，则- 如果
IsConstructor (C) 为true ，则- 令 A 为 ?
Construct (C)。
- 令 A 为 ?
- 否则，
- 令 A 为 !
ArrayCreate (0)。
- 令 A 为 !
- 令 iteratorRecord 为 ?
GetIteratorFromMethod (items, usingIterator)。 - 令 k 为 0。
- 重复，
- 如果 k ≥ 253 - 1，则
- 令 error 为
ThrowCompletion (新建的TypeError 对象)。 - 返回 ?
IteratorClose (iteratorRecord, error)。
- 令 error 为
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 为
done ，则 - 如果 mapping 为
true ，则- 令 mappedValue 为
Completion (Call (mapper, thisArg, « next,𝔽 (k) »))。 IfAbruptCloseIterator (mappedValue, iteratorRecord)。
- 令 mappedValue 为
- 否则，
- 令 mappedValue 为 next。
- 令 defineStatus 为
Completion (CreateDataPropertyOrThrow (A, Pk, mappedValue))。 IfAbruptCloseIterator (defineStatus, iteratorRecord)。- 令 k 为 k + 1。
- 如果 k ≥ 253 - 1，则
- 如果
- 注：items 不是
可迭代对象 ，因此假定其为类数组对象 。 - 令 arrayLike 为 !
ToObject (items)。 - 令 len 为 ?
LengthOfArrayLike (arrayLike)。 - 如果
IsConstructor (C) 为true ，则 - 否则，
- 令 A 为 ?
ArrayCreate (len)。
- 令 A 为 ?
- 令 k 为 0。
- 重复，直到 k < len，
- 执行 ?
Set (A,"length" ,𝔽 (len),true )。 - 返回 A。
23.1.2.2 Array.isArray ( arg )
当调用该函数时，执行以下步骤：
- 返回 ?
IsArray (arg)。
23.1.2.3 Array.of ( ...items )
当调用该方法时，执行以下步骤：
- 令 len 为 items 中元素的数量。
- 令 lenNumber 为
𝔽 (len)。 - 令 C 为
this 值。 - 如果
IsConstructor (C) 为true ，则- 令 A 为 ?
Construct (C, « lenNumber »)。
- 令 A 为 ?
- 否则，
- 令 A 为 ?
ArrayCreate (len)。
- 令 A 为 ?
- 令 k 为 0。
- 重复，直到 k < len，
- 令 kValue 为 items[k]。
- 令 Pk 为 !
ToString (𝔽 (k))。 - 执行 ?
CreateDataPropertyOrThrow (A, Pk, kValue)。 - 令 k 为 k + 1。
- 执行 ?
Set (A,"length" , lenNumber,true )。 - 返回 A。
23.1.2.4 Array.prototype
Array.prototype 的值为
该属性具有属性 { [[Writable]]:
23.1.2.5 get Array [ %Symbol.species% ]
Array[%Symbol.species%] 是一个
- 返回
this 值。
该函数的
数组原型方法通常使用其
23.1.3 数组原型对象的属性
数组原型对象：
- 即 %Array.prototype%。
- 是
数组特殊对象 ，并具有该类对象指定的内部方法。 - 具有一个
"length" 属性，其初始值为+0 𝔽，属性特性为 { [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }。 - 具有一个名为 [[Prototype]] 的内部槽，其值为
%Object.prototype% 。
数组原型对象被指定为
23.1.3.1 Array.prototype.at ( index )
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 如果 relativeIndex ≥ 0，则
- 令 k 为 relativeIndex。
- 否则，
- 令 k 为 len + relativeIndex。
- 如果 k < 0 或 k ≥ len，返回
undefined 。 - 返回 ?
Get (O, !ToString (𝔽 (k)))。
23.1.3.2 Array.prototype.concat ( ...items )
该方法返回一个数组，包含该对象的数组元素后跟每个参数的数组元素。
调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 A 为 ?
ArraySpeciesCreate (O, 0)。 - 令 n 为 0。
- 将 O 前置到 items。
- 对 items 的每个元素 E，执行
- 令 spreadable 为 ?
IsConcatSpreadable (E)。 - 如果 spreadable 为
true ，则- 令 len 为 ?
LengthOfArrayLike (E)。 - 如果 n + len > 253 - 1，抛出
TypeError 异常。 - 令 k 为 0。
- 重复，直到 k < len，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 exists 为 ?
HasProperty (E, Pk)。 - 如果 exists 为
true ，则- 令 subElement 为 ?
Get (E, Pk)。 - 执行 ?
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), subElement)。
- 令 subElement 为 ?
- 令 n 为 n + 1。
- 令 k 为 k + 1。
- 令 Pk 为 !
- 令 len 为 ?
- 否则，
- 注：E 作为单项加入而不是展开。
- 如果 n ≥ 253 - 1，抛出
TypeError 异常。 - 执行 ?
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), E)。 - 令 n 为 n + 1。
- 令 spreadable 为 ?
- 执行 ?
Set (A,"length" ,𝔽 (n),true )。 - 返回 A。
该方法的
在步骤
该方法被设计为泛型；不要求其
23.1.3.2.1 IsConcatSpreadable ( O )
抽象操作 IsConcatSpreadable 接收参数 O（一个
- 如果 O
不是对象 ，返回false 。 - 令 spreadable 为 ?
Get (O,%Symbol.isConcatSpreadable% )。 - 如果 spreadable 不为
undefined ，返回ToBoolean (spreadable)。 - 返回 ?
IsArray (O)。
23.1.3.3 Array.prototype.constructor
Array.prototype.constructor 的初始值为
23.1.3.4 Array.prototype.copyWithin ( target, start [ , end ] )
end 参数是可选的。如果未提供，则使用
如果 target 为负数，则视为
调用该方法时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 relativeTarget 为 ?
ToIntegerOrInfinity (target)。 - 如果 relativeTarget = -∞，令 to 为 0。
- 否则如果 relativeTarget < 0，令 to 为
max (len + relativeTarget, 0)。 - 否则，令 to 为
min (relativeTarget, len)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，令 from 为 0。
- 否则如果 relativeStart < 0，令 from 为
max (len + relativeStart, 0)。 - 否则，令 from 为
min (relativeStart, len)。 - 如果 end 为
undefined ，令 relativeEnd 为 len；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，令 final 为 0。
- 否则如果 relativeEnd < 0，令 final 为
max (len + relativeEnd, 0)。 - 否则，令 final 为
min (relativeEnd, len)。 - 令 count 为
min (final - from, len - to)。 - 如果 from < to 且 to < from +
count，则
- 令 direction 为 -1。
- 设置 from 为 from + count - 1。
- 设置 to 为 to + count - 1。
- 否则，
- 令 direction 为 1。
- 重复，直到 count > 0，
- 令 fromKey 为 !
ToString (𝔽 (from))。 - 令 toKey 为 !
ToString (𝔽 (to))。 - 令 fromPresent 为 ?
HasProperty (O, fromKey)。 - 如果 fromPresent 为
true ，则 - 否则，
断言 ：fromPresent 为false 。- 执行 ?
DeletePropertyOrThrow (O, toKey)。
- 设置 from 为 from + direction。
- 设置 to 为 to + direction。
- 设置 count 为 count - 1。
- 令 fromKey 为 !
- 返回 O。
该方法被设计为泛型；它不要求其
23.1.3.5 Array.prototype.entries ( )
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 返回
CreateArrayIterator (O,key+value )。
23.1.3.6 Array.prototype.every ( callback [ , thisArg ] )
callback 应该是一个接受三个参数并返回可转换为布尔值的函数。every 会按升序对数组中实际存在的每个元素调用
callback 一次，直到遇到一个 callback 返回 every 会立即返回
every 返回
如果提供了 thisArg 参数，则每次调用 callback 时都会用作
callback 被调用时有三个参数：元素的值、元素的索引、被遍历的对象。
every 不会直接修改它所调用的对象，但该对象可能会被 callback 的调用修改。
every 处理的元素范围在第一次调用 callback 前就已确定。调用 every
之后添加到数组的元素不会被 callback 访问。如果数组中已存在的元素被修改，则传递给 callback 的值是在
every 访问该元素时的值；在 every
调用开始后被删除且尚未被访问的元素不会被访问。every 的行为类似于数学中的“全称量词”。特别地，对于空数组，它返回
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 k 为 0。
- 重复，直到 k < len，
- 返回
true 。
该方法被设计为泛型；它不要求其
23.1.3.7 Array.prototype.fill ( value [ , start [ , end ] ] )
start 参数是可选的。如果未提供，则使用
end 参数是可选的。如果未提供，则使用
如果 start 为负数，则视为
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，令 k 为 0。
- 否则如果 relativeStart < 0，令 k 为
max (len + relativeStart, 0)。 - 否则，令 k 为
min (relativeStart, len)。 - 如果 end 为
undefined ，令 relativeEnd 为 len；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，令 final 为 0。
- 否则如果 relativeEnd < 0，令 final 为
max (len + relativeEnd, 0)。 - 否则，令 final 为
min (relativeEnd, len)。 - 重复，直到 k < final，
- 返回 O。
该方法被设计为泛型；它不要求其
23.1.3.8 Array.prototype.filter ( callback [ , thisArg ] )
callback 应该是一个接受三个参数并返回可转换为布尔值的函数。filter 会按升序对数组中每个元素调用
callback 一次，并构造一个包含所有 callback 返回
如果提供了 thisArg 参数，则每次调用 callback 时都会用作
callback 被调用时有三个参数：元素的值、元素的索引、被遍历的对象。
filter 不会直接修改它所调用的对象，但该对象可能会被 callback 的调用修改。
filter 处理的元素范围在第一次调用 callback 前就已确定。调用 filter
之后添加到数组的元素不会被 callback 访问。如果数组中已存在的元素被修改，则传递给 callback 的值是在
filter 访问该元素时的值；在 filter 调用开始后被删除且尚未被访问的元素不会被访问。
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 A 为 ?
ArraySpeciesCreate (O, 0)。 - 令 k 为 0。
- 令 to 为 0。
- 重复，直到 k < len，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 ?
HasProperty (O, Pk)。 - 如果 kPresent 为
true ，则 - 设置 k 为 k + 1。
- 令 Pk 为 !
- 返回 A。
该方法被设计为泛型；它不要求其
23.1.3.9 Array.prototype.find ( predicate [ , thisArg ] )
该方法会按索引升序对数组的每个元素调用 predicate 一次，直到找到一个 predicate 返回可转换为
find
会立即返回该元素的值。否则，find 返回
更多信息见
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 findRec 为 ?
FindViaPredicate (O, len,ascending , predicate, thisArg)。 - 返回 findRec.[[Value]]。
该方法被设计为泛型；它不要求其
23.1.3.10 Array.prototype.findIndex ( predicate [ , thisArg ] )
该方法会按索引升序对数组的每个元素调用 predicate 一次，直到找到一个 predicate 返回可转换为
findIndex
会立即返回该元素的索引。否则，findIndex 返回 -1。
更多信息见
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 findRec 为 ?
FindViaPredicate (O, len,ascending , predicate, thisArg)。 - 返回 findRec.[[Index]]。
该方法被设计为泛型；它不要求其
23.1.3.11 Array.prototype.findLast ( predicate [ , thisArg ] )
该方法会按索引降序对数组的每个元素调用 predicate 一次，直到找到一个 predicate 返回可转换为
findLast
会立即返回该元素的值。否则，findLast 返回
更多信息见
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 findRec 为 ?
FindViaPredicate (O, len,descending , predicate, thisArg)。 - 返回 findRec.[[Value]]。
该方法被设计为泛型；它不要求其
23.1.3.12 Array.prototype.findLastIndex ( predicate [ , thisArg ] )
该方法会按索引降序对数组的每个元素调用 predicate 一次，直到找到一个 predicate 返回可转换为
findLastIndex
会立即返回该元素的索引。否则，findLastIndex 返回 -1。
更多信息见
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 findRec 为 ?
FindViaPredicate (O, len,descending , predicate, thisArg)。 - 返回 findRec.[[Index]]。
该方法被设计为泛型；它不要求其
23.1.3.12.1 FindViaPredicate ( O, len, direction, predicate, thisArg )
抽象操作 FindViaPredicate 接收参数 O（一个对象）、len（一个非负
O 应为
predicate 应为一个函数。对数组的每个元素调用时，传递三个参数：元素的值、元素的索引和被遍历的对象。其返回值会被转换为布尔值。
thisArg 会作为每次调用 predicate 时的
该操作不会直接修改其调用的对象，但该对象可能会被 predicate 的调用修改。
处理的元素范围在首次调用 predicate 前（遍历开始前）就已确定。遍历后添加到数组的元素不会被 predicate
访问。如果数组中已存在的元素被修改，则传递给 predicate
的值为操作访问该元素时的值。在遍历开始后被删除且尚未被访问的元素依然会被访问，要么从原型获取，要么为
调用时执行以下步骤：
- 如果
IsCallable (predicate) 为false ，抛出TypeError 异常。 - 如果 direction 是
ascending ，则- 令 indices 为从 0（含）到 len（不含）区间内所有整数按升序排列的
列表 。
- 令 indices 为从 0（含）到 len（不含）区间内所有整数按升序排列的
- 否则，
- 令 indices 为从 0（含）到 len（不含）区间内所有整数按降序排列的
列表 。
- 令 indices 为从 0（含）到 len（不含）区间内所有整数按降序排列的
- 对于 indices 中的每个整数 k，执行
- 返回
记录 { [[Index]]:-1 𝔽, [[Value]]:undefined }.
23.1.3.13 Array.prototype.flat ( [ depth ] )
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 sourceLen 为 ?
LengthOfArrayLike (O)。 - 令 depthNum 为 1。
- 如果 depth 不等于
undefined ，则- 设置 depthNum 为 ?
ToIntegerOrInfinity (depth)。 - 如果 depthNum < 0，设置 depthNum 为 0。
- 设置 depthNum 为 ?
- 令 A 为 ?
ArraySpeciesCreate (O, 0)。 - 执行 ?
FlattenIntoArray (A, O, sourceLen, 0, depthNum)。 - 返回 A。
23.1.3.13.1 FlattenIntoArray ( target, source, sourceLen, start, depth [ , mapperFunction [ , thisArg ] ] )
抽象操作 FlattenIntoArray 接收参数
target（一个对象）、source（一个对象）、sourceLen（一个非负
断言 ：如果 mapperFunction 存在，则IsCallable (mapperFunction) 为true ，thisArg 存在，且 depth 为 1。- 令 targetIndex 为 start。
- 令 sourceIndex 为
+0 𝔽。 - 重复，直到
ℝ (sourceIndex) < sourceLen，- 令 P 为 !
ToString (sourceIndex)。 - 令 exists 为 ?
HasProperty (source, P)。 - 如果 exists 为
true ，则- 令 element 为 ?
Get (source, P)。 - 如果 mapperFunction 存在，则
- 设置 element 为 ?
Call (mapperFunction, thisArg, « element, sourceIndex, source »)。
- 设置 element 为 ?
- 令 shouldFlatten 为
false 。 - 如果 depth > 0，则
- 设置 shouldFlatten 为 ?
IsArray (element)。
- 设置 shouldFlatten 为 ?
- 如果 shouldFlatten 为
true ，则- 如果 depth = +∞，令 newDepth 为 +∞。
- 否则，令 newDepth 为 depth - 1。
- 令 elementLen 为 ?
LengthOfArrayLike (element)。 - 设置 targetIndex 为 ?
FlattenIntoArray (target, element, elementLen, targetIndex, newDepth)。
- 否则，
- 如果 targetIndex ≥ 253 - 1，抛出
TypeError 异常。 - 执行 ?
CreateDataPropertyOrThrow (target, !ToString (𝔽 (targetIndex)), element)。 - 设置 targetIndex 为 targetIndex + 1。
- 如果 targetIndex ≥ 253 - 1，抛出
- 令 element 为 ?
- 设置 sourceIndex 为 sourceIndex +
1 𝔽。
- 令 P 为 !
- 返回 targetIndex。
23.1.3.14 Array.prototype.flatMap ( mapperFunction [ , thisArg ] )
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 sourceLen 为 ?
LengthOfArrayLike (O)。 - 如果
IsCallable (mapperFunction) 为false ，抛出TypeError 异常。 - 令 A 为 ?
ArraySpeciesCreate (O, 0)。 - 执行 ?
FlattenIntoArray (A, O, sourceLen, 0, 1, mapperFunction, thisArg)。 - 返回 A。
23.1.3.15 Array.prototype.forEach ( callback [ , thisArg ] )
callback 应该是一个接受三个参数的函数。forEach 对数组中实际存在的每个元素按升序调用
callback 一次。callback 只会对数组中实际存在的元素调用，不会对数组中缺失的元素调用。
如果提供了 thisArg 参数，则每次调用 callback 时都会用作
callback 被调用时有三个参数：元素的值、元素的索引、被遍历的对象。
forEach 不会直接修改它所调用的对象，但该对象可能会被 callback 的调用修改。
forEach 处理的元素范围在第一次调用 callback 前就已确定。调用 forEach
之后添加到数组的元素不会被 callback 访问。如果数组中已存在的元素被修改，则传递给 callback 的值是在
forEach 访问该元素时的值；在 forEach 调用开始后被删除且尚未被访问的元素不会被访问。
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 k 为 0。
- 重复，直到 k < len，
- 返回
undefined 。
该方法被设计为泛型；它不要求其
23.1.3.16 Array.prototype.includes ( searchElement [ , fromIndex ] )
该方法会按升序将 searchElement 与数组的元素进行比较，使用
可选的第二个参数 fromIndex 默认为
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果 len = 0，返回
false 。 - 令 n 为 ?
ToIntegerOrInfinity (fromIndex)。 断言 ：如果 fromIndex 为undefined ，则 n 为 0。- 如果 n = +∞，返回
false 。 - 否则如果 n = -∞，设置 n 为 0。
- 如果 n ≥ 0，则
- 令 k 为 n。
- 否则，
- 令 k 为 len + n。
- 如果 k < 0，设置 k 为 0。
- 重复，直到 k < len，
- 令 elementK 为 ?
Get (O, !ToString (𝔽 (k)))。 - 如果
SameValueZero (searchElement, elementK) 为true ，返回true 。 - 设置 k 为 k + 1。
- 令 elementK 为 ?
- 返回
false 。
该方法被设计为泛型；它不要求其
该方法有意与类似的 indexOf 方法有两点不同。第一，它使用
23.1.3.17 Array.prototype.indexOf ( searchElement [ , fromIndex ] )
该方法使用
可选的第二个参数 fromIndex 默认为
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果 len = 0，返回
-1 𝔽。 - 令 n 为 ?
ToIntegerOrInfinity (fromIndex)。 断言 ：如果 fromIndex 为undefined ，则 n 为 0。- 如果 n = +∞，返回
-1 𝔽。 - 否则如果 n = -∞，设置 n 为 0。
- 如果 n ≥ 0，则
- 令 k 为 n。
- 否则，
- 令 k 为 len + n。
- 如果 k < 0，设置 k 为 0。
- 重复，直到 k < len，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 ?
HasProperty (O, Pk)。 - 如果 kPresent 为
true ，则- 令 elementK 为 ?
Get (O, Pk)。 - 如果
IsStrictlyEqual (searchElement, elementK) 为true ，返回𝔽 (k)。
- 令 elementK 为 ?
- 设置 k 为 k + 1。
- 令 Pk 为 !
- 返回
-1 𝔽。
该方法被设计为泛型；它不要求其
23.1.3.18 Array.prototype.join ( separator )
该方法将数组的元素转换为字符串，然后用 separator 分隔这些字符串并连接起来。如果没有提供分隔符，则使用单个逗号作为分隔符。
调用时按照以下步骤执行：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果 separator 为
undefined ，令 sep 为"," 。 - 否则，令 sep 为 ?
ToString (separator)。 - 令 R 为空字符串。
- 令 k 为 0。
- 重复，直到 k < len，
- 返回 R。
该方法被设计为泛型；它不要求其
23.1.3.19 Array.prototype.keys ( )
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 返回
CreateArrayIterator (O,key )。
23.1.3.20 Array.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
该方法会按降序将 searchElement 与数组的元素比较，使用
可选的第二个参数 fromIndex 默认为数组长度减一（即搜索整个数组）。如果它大于等于数组长度，则会搜索整个数组。如果它小于
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果 len = 0，返回
-1 𝔽。 - 如果 fromIndex 存在，令 n 为 ?
ToIntegerOrInfinity (fromIndex)； 否则令 n 为 len - 1。 - 如果 n = -∞，返回
-1 𝔽。 - 如果 n ≥ 0，则
- 令 k 为
min (n, len - 1)。
- 令 k 为
- 否则，
- 令 k 为 len + n。
- 重复，直到 k ≥ 0，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 ?
HasProperty (O, Pk)。 - 如果 kPresent 为
true ，则- 令 elementK 为 ?
Get (O, Pk)。 - 如果
IsStrictlyEqual (searchElement, elementK) 为true ，返回𝔽 (k)。
- 令 elementK 为 ?
- 设置 k 为 k - 1。
- 令 Pk 为 !
- 返回
-1 𝔽。
该方法被设计为泛型；它不要求其
23.1.3.21 Array.prototype.map ( callback [ , thisArg ] )
callback 应该是一个接受三个参数的函数。map 会按升序对数组中每个元素调用
callback 一次，并用结果构造一个新数组。callback
只会对数组中实际存在的元素调用，不会对数组中缺失的元素调用。
如果提供了 thisArg 参数，则每次调用 callback 时都会用作
callback 被调用时有三个参数：元素的值、元素的索引、被遍历的对象。
map 不会直接修改它所调用的对象，但该对象可能会被 callback 的调用修改。
map 处理的元素范围在第一次调用 callback 前就已确定。调用 map
之后添加到数组的元素不会被 callback 访问。如果数组中已存在的元素被修改，则传递给 callback 的值是在
map 访问该元素时的值；在 map 调用开始后被删除且尚未被访问的元素不会被访问。
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 A 为 ?
ArraySpeciesCreate (O, len)。 - 令 k 为 0。
- 重复，直到 k < len，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 ?
HasProperty (O, Pk)。 - 如果 kPresent 为
true ，则- 令 kValue 为 ?
Get (O, Pk)。 - 令 mappedValue 为 ?
Call (callback, thisArg, « kValue,𝔽 (k), O »)。 - 执行 ?
CreateDataPropertyOrThrow (A, Pk, mappedValue)。
- 令 kValue 为 ?
- 设置 k 为 k + 1。
- 令 Pk 为 !
- 返回 A。
该方法被设计为泛型；它不要求其
23.1.3.22 Array.prototype.pop ( )
该方法移除数组的最后一个元素并返回它。
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果 len = 0，则
- 执行 ?
Set (O,"length" ,+0 𝔽,true )。 - 返回
undefined 。
- 执行 ?
- 否则，
该方法被设计为泛型；它不要求其
23.1.3.23 Array.prototype.push ( ...items )
该方法将参数按出现顺序追加到数组末尾。它返回数组的新长度。
该方法调用时执行以下步骤：
该方法的
该方法被设计为泛型；它不要求其
23.1.3.24 Array.prototype.reduce ( callback [ , initialValue ] )
callback 应为一个接受四个参数的函数。reduce 会对数组中第一个元素之后的每个元素按升序以函数形式调用
callback 一次。
callback 被调用时带四个参数：previousValue（上次调用 callback
的值）、currentValue（当前元素的值）、currentIndex 和被遍历的对象。首次调用
callback 时，previousValue 和 currentValue
可能有两种情况。如果调用 reduce 时提供了 initialValue，则
previousValue 为 initialValue，currentValue
为数组的第一个值。如果没有提供 initialValue，则 previousValue
为数组的第一个值，currentValue 为第二个值。如果数组为空且未提供 initialValue，会抛出
reduce 不会直接修改其调用的对象，但对象可能会被 callback 的调用修改。
reduce 处理的元素范围在第一次调用 callback 前就已确定。调用 reduce
后添加到数组的元素不会被 callback 访问。如果数组中已存在的元素被修改，则传递给 callback 的值为
reduce 访问该元素时的值；在 reduce 调用开始后被删除且尚未被访问的元素不会被访问。
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 如果 len = 0 且 initialValue 不存在，抛出
TypeError 异常。 - 令 k 为 0。
- 令 accumulator 为
undefined 。 - 如果 initialValue 存在，则
- 设置 accumulator 为 initialValue。
- 否则，
- 令 kPresent 为
false 。 - 重复，直到 kPresent 为
false 且 k < len，- 令 Pk 为 !
ToString (𝔽 (k))。 - 设置 kPresent 为 ?
HasProperty (O, Pk)。 - 如果 kPresent 为
true ，则- 设置 accumulator 为 ?
Get (O, Pk)。
- 设置 accumulator 为 ?
- 设置 k 为 k + 1。
- 令 Pk 为 !
- 如果 kPresent 为
false ，抛出TypeError 异常。
- 令 kPresent 为
- 重复，直到 k < len，
- 返回 accumulator。
该方法被设计为泛型；它不要求其
23.1.3.25 Array.prototype.reduceRight ( callback [ , initialValue ] )
callback 应为一个接受四个参数的函数。reduceRight
会对数组中第一个元素之后的每个元素按降序以函数形式调用 callback 一次。
callback 被调用时带四个参数：previousValue（上次调用 callback
的值）、currentValue（当前元素的值）、currentIndex
和被遍历的对象。首次调用该函数时，previousValue 和 currentValue 可能有两种情况。如果调用
reduceRight 时提供了 initialValue，则 previousValue 为
initialValue，currentValue 为数组的最后一个值。如果没有提供
initialValue，则 previousValue 为数组的最后一个值，currentValue
为倒数第二个值。如果数组为空且未提供 initialValue，会抛出
reduceRight 不会直接修改其调用的对象，但对象可能会被 callback 的调用修改。
reduceRight 处理的元素范围在第一次调用 callback 前就已确定。调用
reduceRight 后添加到数组的元素不会被 callback 访问。如果数组中已存在的元素被
callback 修改，则传递给 callback 的值为 reduceRight
访问该元素时的值；在 reduceRight 调用开始后被删除且尚未被访问的元素不会被访问。
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 如果 len = 0 且 initialValue 不存在，抛出
TypeError 异常。 - 令 k 为 len - 1。
- 令 accumulator 为
undefined 。 - 如果 initialValue 存在，则
- 设置 accumulator 为 initialValue。
- 否则，
- 令 kPresent 为
false 。 - 重复，直到 kPresent 为
false 且 k ≥ 0，- 令 Pk 为 !
ToString (𝔽 (k))。 - 设置 kPresent 为 ?
HasProperty (O, Pk)。 - 如果 kPresent 为
true ，则- 设置 accumulator 为 ?
Get (O, Pk)。
- 设置 accumulator 为 ?
- 设置 k 为 k - 1。
- 令 Pk 为 !
- 如果 kPresent 为
false ，抛出TypeError 异常。
- 令 kPresent 为
- 重复，直到 k ≥ 0，
- 返回 accumulator。
该方法被设计为泛型；它不要求其
23.1.3.26 Array.prototype.reverse ( )
该方法重新排列数组元素，使其顺序颠倒。它返回反转后的数组。
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 middle 为
floor (len / 2)。 - 令 lower 为 0。
- 重复，直到 lower ≠ middle，
- 令 upper 为 len - lower - 1。
- 令 upperP 为 !
ToString (𝔽 (upper))。 - 令 lowerP 为 !
ToString (𝔽 (lower))。 - 令 lowerExists 为 ?
HasProperty (O, lowerP)。 - 如果 lowerExists 为
true ，则- 令 lowerValue 为 ?
Get (O, lowerP)。
- 令 lowerValue 为 ?
- 令 upperExists 为 ?
HasProperty (O, upperP)。 - 如果 upperExists 为
true ，则- 令 upperValue 为 ?
Get (O, upperP)。
- 令 upperValue 为 ?
- 如果 lowerExists 为
true 且 upperExists 为true ，则 - 否则如果 lowerExists 为
false 且 upperExists 为true ，则- 执行 ?
Set (O, lowerP, upperValue,true )。 - 执行 ?
DeletePropertyOrThrow (O, upperP)。
- 执行 ?
- 否则如果 lowerExists 为
true 且 upperExists 为false ，则- 执行 ?
DeletePropertyOrThrow (O, lowerP)。 - 执行 ?
Set (O, upperP, lowerValue,true )。
- 执行 ?
- 否则，
断言 ：lowerExists 和 upperExists 都为false 。- 注：无操作需要执行。
- 设置 lower 为 lower + 1。
- 返回 O。
该方法被设计为泛型；它不要求其
23.1.3.27 Array.prototype.shift ( )
该方法移除数组的第一个元素并返回它。
调用时按照以下步骤执行：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果 len = 0，则
- 执行 ?
Set (O,"length" ,+0 𝔽,true )。 - 返回
undefined 。
- 执行 ?
- 令 first 为 ?
Get (O,"0" )。 - 令 k 为 1。
- 重复，直到 k < len，
- 令 from 为 !
ToString (𝔽 (k))。 - 令 to 为 !
ToString (𝔽 (k - 1))。 - 令 fromPresent 为 ?
HasProperty (O, from)。 - 如果 fromPresent 为
true ，则 - 否则，
断言 ：fromPresent 为false 。- 执行 ?
DeletePropertyOrThrow (O, to)。
- 设置 k 为 k + 1。
- 令 from 为 !
- 执行 ?
DeletePropertyOrThrow (O, !ToString (𝔽 (len - 1)))。 - 执行 ?
Set (O,"length" ,𝔽 (len - 1),true )。 - 返回 first。
该方法被设计为泛型；它不要求其
23.1.3.28 Array.prototype.slice ( start, end )
该方法返回一个包含数组从元素 start 到（但不包括）元素 end 的元素的新数组（如果 end 是
调用时按照以下步骤执行：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，令 k 为 0。
- 否则如果 relativeStart < 0，令 k 为
max (len + relativeStart, 0)。 - 否则，令 k 为
min (relativeStart, len)。 - 如果 end 为
undefined ，令 relativeEnd 为 len；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，令 final 为 0。
- 否则如果 relativeEnd < 0，令 final 为
max (len + relativeEnd, 0)。 - 否则，令 final 为
min (relativeEnd, len)。 - 令 count 为
max (final - k, 0)。 - 令 A 为 ?
ArraySpeciesCreate (O, count)。 - 令 n 为 0。
- 重复，直到 k < final，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 ?
HasProperty (O, Pk)。 - 如果 kPresent 为
true ，则- 令 kValue 为 ?
Get (O, Pk)。 - 执行 ?
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), kValue)。
- 令 kValue 为 ?
- 设置 k 为 k + 1。
- 设置 n 为 n + 1。
- 令 Pk 为 !
- 执行 ?
Set (A,"length" ,𝔽 (n),true )。 - 返回 A。
第
该方法被设计为泛型；它不要求其
23.1.3.29 Array.prototype.some ( callback [ , thisArg ] )
callback 应为一个接受三个参数并返回可转换为布尔值的函数。some 会对数组中实际存在的每个元素按升序调用
callback，直到找到一个 callback 返回 some 会立即返回 some
返回
如果提供了 thisArg 参数，则每次调用 callback 时都会用作
callback 被调用时有三个参数：元素的值、元素的索引、被遍历的对象。
some 不会直接修改其调用的对象，但该对象可能会被 callback 的调用修改。
some 处理的元素范围在第一次调用 callback 前就已确定。调用 some
后添加到数组的元素不会被 callback 访问。如果数组中已存在的元素被修改，则传递给 callback 的值是在
some 访问该元素时的值；在 some
调用开始后被删除且尚未被访问的元素不会被访问。some 类似于数学中的“存在”量词。特别地，对于空数组，它返回
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 k 为 0。
- 重复，直到 k < len，
- 返回
false 。
该方法被设计为泛型；它不要求其
23.1.3.30 Array.prototype.sort ( comparator )
该方法对数组的元素进行排序。如果 comparator 不为
调用时按照以下步骤执行：
- 如果 comparator 不为
undefined 且IsCallable (comparator) 为false ，抛出TypeError 异常。 - 令 obj 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (obj)。 - 令 SortCompare 为一个新的
抽象闭包 ，带参数 (x, y)，捕获 comparator 并在调用时执行以下步骤：- 返回 ?
CompareArrayElements (x, y, comparator)。
- 返回 ?
- 令 sortedList 为 ?
SortIndexedProperties (obj, len, SortCompare,skip-holes )。 - 令 itemCount 为 sortedList 中元素的数量。
- 令 j 为 0。
- 重复，直到 j < itemCount，
- 注：第
SortIndexedProperties 步骤（见5 ）使用skip-holes 。剩余索引会被删除，以保留排序前检测到并排除的空洞数量。 - 重复，直到 j < len，
- 执行 ?
DeletePropertyOrThrow (obj, !ToString (𝔽 (j)))。 - 设置 j 为 j + 1。
- 执行 ?
- 返回 obj。
由于不存在的属性值总是大于
该方法被设计为泛型；它不要求其
23.1.3.30.1 SortIndexedProperties ( obj, len, SortCompare, holes )
抽象操作 SortIndexedProperties 接收参数 obj（一个对象）、len（一个非负
- 令 items 为一个新的空
List 。 - 令 k 为 0。
- 重复，直到 k < len，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 如果 holes 为
skip-holes ，则- 令 kRead 为 ?
HasProperty (obj, Pk)。
- 令 kRead 为 ?
- 否则，
断言 ：holes 为read-through-holes 。- 令 kRead 为
true 。
- 如果 kRead 为
true ，则- 令 kValue 为 ?
Get (obj, Pk)。 - 将 kValue 添加到 items。
- 令 kValue 为 ?
- 设置 k 为 k + 1。
- 令 Pk 为 !
- 使用
实现定义 的 对 SortCompare 的调用序列对 items 进行排序。如果此过程中有任何调用返回异常完成 ，则在进行任何进一步调用 SortCompare 前停止并返回该Completion Record 。 - 返回 items。
排序顺序（sort order）指的是上述算法中第
除非
-
存在对小于 itemCount 的非负
整数 的某个数学排列 π，使得对于每个小于 itemCount 的非负整数 j，有old[j] 与new[π(j)] 完全一致。 -
对所有小于 itemCount 的非负整数 j 和 k，如果
ℝ (SortCompare(old[j], old[k])) < 0π(j) < π(k) 。 -
对所有 j < k < itemCount 的非负整数 j 和
k，如果
ℝ (SortCompare(old[j], old[k])) = 0π(j) < π(k) ；即排序是稳定的。
此处记号
抽象闭包或函数 comparator 对于值集合 S 来说，如果对集合 S 中所有可能的值
a、b、c（可能相同）均满足以下要求，则称其为 一致性比较器。记号
-
对于给定的 a 和 b，每次调用 comparator(a,
b) 总是返回相同的值 v。此外，v
是一个 Number ，且 v 不是NaN 。这意味着对于一对 a 和 b，a <C b、a =C b、a >C b 三者必有其一为真。 - 调用 comparator(a, b) 不会修改 obj 或其原型链上的任何对象。
- a =C a（自反性）
- 如果 a =C b，则 b =C a（对称性）
- 如果 a =C b 且 b =C c，则 a =C c（传递性）
- 如果 a <C b 且 b <C c，则 a <C c（传递性）
- 如果 a >C b 且 b >C c，则 a >C c（传递性）
上述条件是保证 comparator 将集合 S 划分为等价类并且这些等价类是全序所必需且充分的条件。
23.1.3.30.2 CompareArrayElements ( x, y, comparator )
抽象操作 CompareArrayElements 接收参数 x（一个
- 如果 x 和 y 都是
undefined ，返回+0 𝔽。 - 如果 x 是
undefined ，返回1 𝔽。 - 如果 y 是
undefined ，返回-1 𝔽。 - 如果 comparator 不为
undefined ，则 - 令 xString 为 ?
ToString (x)。 - 令 yString 为 ?
ToString (y)。 - 令 xSmaller 为 !
IsLessThan (xString, yString,true )。 - 如果 xSmaller 为
true ，返回-1 𝔽。 - 令 ySmaller 为 !
IsLessThan (yString, xString,true )。 - 如果 ySmaller 为
true ，返回1 𝔽。 - 返回
+0 𝔽。
23.1.3.31 Array.prototype.splice ( start, deleteCount, ...items )
该方法从整数索引 start 开始，删除数组中的 deleteCount 个元素，并用 items 的元素替换它们。它返回一个包含被删除元素（如有）的数组。
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，令 actualStart 为 0。
- 否则如果 relativeStart < 0，令 actualStart 为
max (len + relativeStart, 0)。 - 否则，令 actualStart 为
min (relativeStart, len)。 - 令 itemCount 为 items 中元素的数量。
- 如果未传入 start，则
- 令 actualDeleteCount 为 0。
- 否则如果未传入 deleteCount，则
- 令 actualDeleteCount 为 len - actualStart。
- 否则，
- 令 dc 为 ?
ToIntegerOrInfinity (deleteCount)。 - 令 actualDeleteCount 为将 dc 限制在 0 到 len - actualStart 之间的结果。
- 令 dc 为 ?
- 如果 len + itemCount - actualDeleteCount >
253 - 1，抛出
TypeError 异常。 - 令 A 为 ?
ArraySpeciesCreate (O, actualDeleteCount)。 - 令 k 为 0。
- 重复，直到 k < actualDeleteCount，
- 令 from 为 !
ToString (𝔽 (actualStart + k))。 - 如果 ?
HasProperty (O, from) 为true ，则- 令 fromValue 为 ?
Get (O, from)。 - 执行 ?
CreateDataPropertyOrThrow (A, !ToString (𝔽 (k)), fromValue)。
- 令 fromValue 为 ?
- 设置 k 为 k + 1。
- 令 from 为 !
- 执行 ?
Set (A,"length" ,𝔽 (actualDeleteCount),true )。 - 如果 itemCount < actualDeleteCount，则
- 设置 k 为 actualStart。
- 重复，直到 k < (len -
actualDeleteCount)，
- 令 from 为 !
ToString (𝔽 (k + actualDeleteCount))。 - 令 to 为 !
ToString (𝔽 (k + itemCount))。 - 如果 ?
HasProperty (O, from) 为true ，则 - 否则，
- 执行 ?
DeletePropertyOrThrow (O, to)。
- 执行 ?
- 设置 k 为 k + 1。
- 令 from 为 !
- 设置 k 为 len。
- 重复，直到 k > (len -
actualDeleteCount + itemCount)，
- 执行 ?
DeletePropertyOrThrow (O, !ToString (𝔽 (k - 1)))。 - 设置 k 为 k - 1。
- 执行 ?
- 否则如果 itemCount > actualDeleteCount，则
- 设置 k 为 (len - actualDeleteCount)。
- 重复，直到 k > actualStart，
- 令 from 为 !
ToString (𝔽 (k + actualDeleteCount - 1))。 - 令 to 为 !
ToString (𝔽 (k + itemCount - 1))。 - 如果 ?
HasProperty (O, from) 为true ，则 - 否则，
- 执行 ?
DeletePropertyOrThrow (O, to)。
- 执行 ?
- 设置 k 为 k - 1。
- 令 from 为 !
- 设置 k 为 actualStart。
- 对于 items 的每个元素 E，执行
- 执行 ?
Set (O,"length" ,𝔽 (len - actualDeleteCount + itemCount),true )。 - 返回 A。
该方法被设计为泛型；它不要求其
23.1.3.32 Array.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按照 ECMA-402 规范实现此方法。如果 ECMAScript 实现不包含 ECMA-402 API，则使用下面对该方法的规范。
ECMA-402 第一版未包含该方法的替代规范。
此方法的可选参数含义在 ECMA-402 规范中定义；不包含 ECMA-402 支持的实现不得将这些参数位置用于其他用途。
该方法调用时执行以下步骤：
- 令 array 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (array)。 - 令 separator 为适用于
宿主环境 当前区域设置的实现定义 列表分隔符字符串值（如", " ）。 - 令 R 为空字符串。
- 令 k 为 0。
- 重复，直到 k < len，
- 返回 R。
该方法使用元素各自的 toLocaleString
方法将数组元素转换为字符串，然后用实现定义的、区分区域设置的分隔符字符串把这些字符串连接起来。此方法类似于 toString，但目的是生成符合
该方法被设计为泛型；它不要求其
23.1.3.33 Array.prototype.toReversed ( )
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 A 为 ?
ArrayCreate (len)。 - 令 k 为 0。
- 重复，直到 k < len，
- 返回 A。
23.1.3.34 Array.prototype.toSorted ( comparator )
该方法调用时执行以下步骤：
- 如果 comparator 不为
undefined 且IsCallable (comparator) 为false ，抛出TypeError 异常。 - 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 A 为 ?
ArrayCreate (len)。 - 令 SortCompare 为一个新的
抽象闭包 ，带参数 (x, y)，捕获 comparator 并在调用时执行以下步骤：- 返回 ?
CompareArrayElements (x, y, comparator)。
- 返回 ?
- 令 sortedList 为 ?
SortIndexedProperties (O, len, SortCompare,read-through-holes )。 - 令 j 为 0。
- 重复，直到 j < len，
- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (j)), sortedList[j])。 - 设置 j 为 j + 1。
- 执行 !
- 返回 A。
23.1.3.35 Array.prototype.toSpliced ( start, skipCount, ...items )
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，令 actualStart 为 0。
- 否则如果 relativeStart < 0，令 actualStart 为
max (len + relativeStart, 0)。 - 否则，令 actualStart 为
min (relativeStart, len)。 - 令 insertCount 为 items 中元素的数量。
- 如果未传入 start，则
- 令 actualSkipCount 为 0。
- 否则如果未传入 skipCount，则
- 令 actualSkipCount 为 len - actualStart。
- 否则，
- 令 sc 为 ?
ToIntegerOrInfinity (skipCount)。 - 令 actualSkipCount 为将 sc 限制在 0 到 len - actualStart 之间的结果。
- 令 sc 为 ?
- 令 newLen 为 len + insertCount - actualSkipCount。
- 如果 newLen > 253 - 1，抛出
TypeError 异常。 - 令 A 为 ?
ArrayCreate (newLen)。 - 令 i 为 0。
- 令 r 为 actualStart + actualSkipCount。
- 重复，直到 i < actualStart，
- 令 Pi 为 !
ToString (𝔽 (i))。 - 令 iValue 为 ?
Get (O, Pi)。 - 执行 !
CreateDataPropertyOrThrow (A, Pi, iValue)。 - 设置 i 为 i + 1。
- 令 Pi 为 !
- 对于 items 的每个元素 E，执行
- 令 Pi 为 !
ToString (𝔽 (i))。 - 执行 !
CreateDataPropertyOrThrow (A, Pi, E)。 - 设置 i 为 i + 1。
- 令 Pi 为 !
- 重复，直到 i < newLen，
- 返回 A。
23.1.3.36 Array.prototype.toString ( )
该方法调用时执行以下步骤：
- 令 array 为 ?
ToObject (this 值)。 - 令 func 为 ?
Get (array,"join" )。 - 如果
IsCallable (func) 为false ，则将 func 设为内建函数 %Object.prototype.toString%。 - 返回 ?
Call (func, array)。
该方法被设计为泛型；它不要求其
23.1.3.37 Array.prototype.unshift ( ...items )
该方法将参数添加到数组的开头，其在数组中的顺序与参数列表中的顺序相同。
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 argCount 为 items 中元素的数量。
- 如果 argCount > 0，则
- 如果 len + argCount > 253 - 1，抛出
TypeError 异常。 - 令 k 为 len。
- 重复，直到 k > 0，
- 令 from 为 !
ToString (𝔽 (k - 1))。 - 令 to 为 !
ToString (𝔽 (k + argCount - 1))。 - 令 fromPresent 为 ?
HasProperty (O, from)。 - 如果 fromPresent 为
true ，则 - 否则，
断言 : fromPresent 为false 。- 执行 ?
DeletePropertyOrThrow (O, to)。
- 设置 k 为 k - 1。
- 令 from 为 !
- 令 j 为
+0 𝔽。 - 对于 items 的每个元素 E，执行
- 如果 len + argCount > 253 - 1，抛出
- 执行 ?
Set (O,"length" ,𝔽 (len + argCount),true )。 - 返回
𝔽 (len + argCount)。
该方法的
该方法被设计为泛型；它不要求其
23.1.3.38 Array.prototype.values ( )
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 返回
CreateArrayIterator (O,value )。
23.1.3.39 Array.prototype.with ( index, value )
该方法调用时执行以下步骤：
- 令 O 为 ?
ToObject (this 值)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 如果 relativeIndex ≥ 0，令 actualIndex 为 relativeIndex。
- 否则，令 actualIndex 为 len + relativeIndex。
- 如果 actualIndex ≥ len 或 actualIndex < 0，抛出
RangeError 异常。 - 令 A 为 ?
ArrayCreate (len)。 - 令 k 为 0。
- 重复，直到 k < len，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 如果 k = actualIndex，令 fromValue 为 value。
- 否则，令 fromValue 为 ?
Get (O, Pk)。 - 执行 !
CreateDataPropertyOrThrow (A, Pk, fromValue)。 - 设置 k 为 k + 1。
- 令 Pk 为 !
- 返回 A。
23.1.3.40 Array.prototype [ %Symbol.iterator% ] ( )
23.1.3.41 Array.prototype [ %Symbol.unscopables% ]
- 令 unscopableList 为
OrdinaryObjectCreate (null )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"at" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"copyWithin" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"entries" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"fill" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"find" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"findIndex" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"findLast" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"findLastIndex" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"flat" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"flatMap" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"includes" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"keys" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"toReversed" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"toSorted" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"toSpliced" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"values" ,true )。 - 返回 unscopableList。
该属性具有属性 { [[Writable]]:
该对象的自有属性名是在 ECMAScript 2015 规范之前未作为 Array.prototype 标准属性包含的属性名。这些名称在
with 语句绑定时会被忽略，以保持现有代码的行为，这些代码可能在外部作用域中使用其中的某个名称作为绑定，而该作用域被
with 语句（其绑定对象为数组）所遮蔽。
23.1.4 数组实例的属性
数组实例是
数组实例有一个
23.1.4.1 length
Array 实例的
23.1.5 数组迭代器对象
数组迭代器是一个表示对某个特定数组实例对象的特定迭代的对象。数组迭代器对象没有命名的
23.1.5.1 CreateArrayIterator ( array, kind )
抽象操作 CreateArrayIterator 接收参数 array（一个对象）和
kind（
- 令 iterator 为
OrdinaryObjectCreate (%ArrayIteratorPrototype% , « [[IteratedArrayLike]], [[ArrayLikeNextIndex]], [[ArrayLikeIterationKind]] »)。 - 设置 iterator.[[IteratedArrayLike]] 为 array。
- 设置 iterator.[[ArrayLikeNextIndex]] 为 0。
- 设置 iterator.[[ArrayLikeIterationKind]] 为 kind。
- 返回 iterator。
23.1.5.2 %ArrayIteratorPrototype% 对象
%ArrayIteratorPrototype% 对象：
- 拥有所有
数组迭代器对象 继承的属性。 - 是一个
普通对象 。 - 具有 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 具有以下属性：
23.1.5.2.1 %ArrayIteratorPrototype%.next ( )
- 令 O 为
this 值。 - 如果 O
不是对象 ，抛出TypeError 异常。 - 如果 O 不具有
数组迭代器 实例（23.1.5.3 ）的所有内部槽，抛出TypeError 异常。 - 令 array 为 O.[[IteratedArrayLike]]。
- 如果 array 为
undefined ，返回CreateIteratorResultObject (undefined ,true )。 - 令 index 为 O.[[ArrayLikeNextIndex]]。
- 令 kind 为 O.[[ArrayLikeIterationKind]]。
- 如果 array 具有 [[TypedArrayName]] 内部槽，则
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (array,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 为true ，抛出TypeError 异常。 - 令 len 为
TypedArrayLength (taRecord)。
- 令 taRecord 为
- 否则，
- 令 len 为 ?
LengthOfArrayLike (array)。
- 令 len 为 ?
- 如果 index ≥ len，则
- 设置 O.[[IteratedArrayLike]] 为
undefined 。 - 返回
CreateIteratorResultObject (undefined ,true )。
- 设置 O.[[IteratedArrayLike]] 为
- 设置 O.[[ArrayLikeNextIndex]] 为 index + 1。
- 令 indexNumber 为
𝔽 (index)。 - 如果 kind 是
key ，则- 令 result 为 indexNumber。
- 否则，
- 令 elementKey 为 !
ToString (indexNumber)。 - 令 elementValue 为 ?
Get (array, elementKey)。 - 如果 kind 是
value ，则- 令 result 为 elementValue。
- 否则，
断言 : kind 是key+value 。- 令 result 为
CreateArrayFromList (« indexNumber, elementValue »)。
- 令 elementKey 为 !
- 返回
CreateIteratorResultObject (result,false )。
23.1.5.2.2 %ArrayIteratorPrototype% [ %Symbol.toStringTag% ]
该属性具有属性 { [[Writable]]:
23.1.5.3 数组迭代器实例的属性
23.2 TypedArray 对象
TypedArray 展示了一个底层二进制数据缓冲区（
|
|
元素类型 | 元素大小 | 转换操作 | 描述 |
|---|---|---|---|---|
|
Int8Array %Int8Array% |
|
1 |
|
8 位二进制补码有符号 |
|
Uint8Array %Uint8Array% |
|
1 |
|
8 位无符号 |
|
Uint8ClampedArray %Uint8ClampedArray% |
|
1 |
|
8 位无符号 |
|
Int16Array %Int16Array% |
|
2 |
|
16 位二进制补码有符号 |
|
Uint16Array %Uint16Array% |
|
2 |
|
16 位无符号 |
|
Int32Array %Int32Array% |
|
4 |
|
32 位二进制补码有符号 |
|
Uint32Array %Uint32Array% |
|
4 |
|
32 位无符号 |
|
BigInt64Array %BigInt64Array% |
|
8 |
|
64 位二进制补码有符号 |
|
BigUint64Array %BigUint64Array% |
|
8 |
|
64 位无符号 |
|
Float16Array %Float16Array% |
|
2 | 16 位 IEEE 浮点数 | |
|
Float32Array %Float32Array% |
|
4 | 32 位 IEEE 浮点数 | |
|
Float64Array %Float64Array% |
|
8 | 64 位 IEEE 浮点数 |
在下述定义中，对 TypedArray 的引用应替换为上表中相应的
23.2.1 %TypedArray% 内建对象
%TypedArray% 内建对象：
- 是一个
构造函数 函数对象 ，所有 TypedArray构造函数 对象都继承自它。 - 与其对应的原型对象一起，提供所有 TypedArray
构造函数 及其实例继承的公共属性。 - 没有全局名称，也不会作为
全局对象 的属性出现。 - 作为各类 TypedArray
构造函数 的抽象超类。 - 因为它是一个抽象类
构造函数 ，所以调用会抛出错误。TypedArray构造函数 不会对它执行super调用。
23.2.1.1 %TypedArray% ( )
该函数被调用时执行以下步骤：
- 抛出
TypeError 异常。
该函数的
23.2.2 %TypedArray% 内建对象的属性
- 拥有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 有一个
"name" 属性，其值为"TypedArray" 。 - 有如下属性：
23.2.2.1 %TypedArray%.from ( source [ , mapper [ , thisArg ] ] )
该方法被调用时执行以下步骤：
- 令 C 为
this 值。 - 如果
IsConstructor (C) 为false ，抛出TypeError 异常。 - 如果 mapper 为
undefined ，则- 令 mapping 为
false 。
- 令 mapping 为
- 否则，
- 如果
IsCallable (mapper) 为false ，抛出TypeError 异常。 - 令 mapping 为
true 。
- 如果
- 令 usingIterator 为 ?
GetMethod (source,%Symbol.iterator% ). - 如果 usingIterator 不为
undefined ，则- 令 values 为 ?
IteratorToList (?GetIteratorFromMethod (source, usingIterator))。 - 令 len 为 values 中元素的数量。
- 令 targetObj 为 ?
TypedArrayCreateFromConstructor (C, «𝔽 (len) »)。 - 令 k 为 0。
- 重复，直到 k < len，
断言 ：values 现在是一个空的List 。- 返回 targetObj。
- 令 values 为 ?
- 注：source 不是
可迭代对象 ，所以假定它已经是类数组对象 。 - 令 arrayLike 为 !
ToObject (source)。 - 令 len 为 ?
LengthOfArrayLike (arrayLike)。 - 令 targetObj 为 ?
TypedArrayCreateFromConstructor (C, «𝔽 (len) »)。 - 令 k 为 0。
- 重复，直到 k < len，
- 返回 targetObj。
23.2.2.2 %TypedArray%.of ( ...items )
该方法被调用时执行以下步骤：
- 令 len 为 items 中元素的数量。
- 令 C 为
this 值。 - 如果
IsConstructor (C) 为false ，抛出TypeError 异常。 - 令 newObj 为 ?
TypedArrayCreateFromConstructor (C, «𝔽 (len) »)。 - 令 k 为 0。
- 重复，直到 k < len，
- 返回 newObj。
23.2.2.3 %TypedArray%.prototype
.prototype
的初始值为
该属性具有属性 { [[Writable]]:
23.2.2.4 get %TypedArray% [ %Symbol.species% ]
[%Symbol.species%]
是一个
- 返回
this 值。
该函数的
23.2.3 %TypedArray% 原型对象的属性
%TypedArray% 原型对象：
- 拥有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 即 %TypedArray.prototype%。
- 是一个
普通对象 。 - 没有 [[ViewedArrayBuffer]] 或其它 TypedArray 实例对象专有的内部槽。
23.2.3.1 %TypedArray%.prototype.at ( index )
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 如果 relativeIndex ≥ 0，则
- 令 k 为 relativeIndex。
- 否则，
- 令 k 为 len + relativeIndex。
- 如果 k < 0 或 k ≥ len，返回
undefined 。 - 返回 !
Get (O, !ToString (𝔽 (k)))。
23.2.3.2 get %TypedArray%.prototype.buffer
.prototype.buffer
是一个
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[TypedArrayName]])。 断言 ： O 具有 [[ViewedArrayBuffer]] 内部槽。- 令 buffer 为 O.[[ViewedArrayBuffer]]。
- 返回 buffer。
23.2.3.3 get %TypedArray%.prototype.byteLength
.prototype.byteLength
是一个
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[TypedArrayName]])。 断言 ： O 具有 [[ViewedArrayBuffer]] 内部槽。- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 令 size 为
TypedArrayByteLength (taRecord)。 - 返回
𝔽 (size)。
23.2.3.4 get %TypedArray%.prototype.byteOffset
.prototype.byteOffset
是一个
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[TypedArrayName]])。 断言 ： O 具有 [[ViewedArrayBuffer]] 内部槽。- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 为true ，返回+0 𝔽。 - 令 offset 为 O.[[ByteOffset]]。
- 返回
𝔽 (offset)。
23.2.3.5 %TypedArray%.prototype.constructor
.prototype.constructor
的初始值为
23.2.3.6 %TypedArray%.prototype.copyWithin ( target, start [ , end ] )
该方法的参数解释和用法与 Array.prototype.copyWithin 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 relativeTarget 为 ?
ToIntegerOrInfinity (target)。 - 如果 relativeTarget = -∞，令 targetIndex 为 0。
- 否则如果 relativeTarget < 0，令 targetIndex 为
max (len + relativeTarget, 0)。 - 否则，令 targetIndex 为
min (relativeTarget, len)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，令 startIndex 为 0。
- 否则如果 relativeStart < 0，令 startIndex 为
max (len + relativeStart, 0)。 - 否则，令 startIndex 为
min (relativeStart, len)。 - 如果 end 为
undefined ，令 relativeEnd 为 len；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，令 endIndex 为 0。
- 否则如果 relativeEnd < 0，令 endIndex 为
max (len + relativeEnd, 0)。 - 否则，令 endIndex 为
min (relativeEnd, len)。 - 令 count 为
min (endIndex - startIndex, len - targetIndex)。 - 如果 count > 0，则
- 注：拷贝操作必须以保持源数据比特级编码的方式执行。
- 令 buffer 为 O.[[ViewedArrayBuffer]]。
- 设置 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 为true ，抛出TypeError 异常。 - 设置 len 为
TypedArrayLength (taRecord)。 - 令 elementSize 为
TypedArrayElementSize (O)。 - 令 byteOffset 为 O.[[ByteOffset]]。
- 令 bufferByteLimit 为 (len × elementSize) + byteOffset。
- 令 toByteIndex 为 (targetIndex × elementSize) + byteOffset。
- 令 fromByteIndex 为 (startIndex × elementSize) + byteOffset。
- 令 countBytes 为 count × elementSize。
- 如果 fromByteIndex < toByteIndex 且
toByteIndex < fromByteIndex +
countBytes，则
- 令 direction 为 -1。
- 设置 fromByteIndex 为 fromByteIndex + countBytes - 1。
- 设置 toByteIndex 为 toByteIndex + countBytes - 1。
- 否则，
- 令 direction 为 1。
- 重复，直到 countBytes > 0，
- 如果 fromByteIndex < bufferByteLimit 且
toByteIndex < bufferByteLimit，则
- 令 value 为
GetValueFromBuffer (buffer, fromByteIndex,uint8 ,true ,unordered )。 - 执行
SetValueInBuffer (buffer, toByteIndex,uint8 , value,true ,unordered )。 - 设置 fromByteIndex 为 fromByteIndex + direction。
- 设置 toByteIndex 为 toByteIndex + direction。
- 设置 countBytes 为 countBytes - 1。
- 令 value 为
- 否则，
- 设置 countBytes 为 0。
- 如果 fromByteIndex < bufferByteLimit 且
toByteIndex < bufferByteLimit，则
- 返回 O。
23.2.3.7 %TypedArray%.prototype.entries ( )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
ValidateTypedArray (O,seq-cst )。 - 返回
CreateArrayIterator (O,key+value )。
23.2.3.8 %TypedArray%.prototype.every ( callback [ , thisArg ] )
该方法的参数解释和用法与 Array.prototype.every 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 k 为 0。
- 重复，直到 k < len，
- 返回
true 。
该方法不是泛型的。
23.2.3.9 %TypedArray%.prototype.fill ( value [ , start [ , end ] ] )
该方法的参数解释和用法与 Array.prototype.fill 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 如果 O.[[ContentType]] 为
bigint ，将 value 设为 ?ToBigInt (value)。 - 否则，将 value 设为 ?
ToNumber (value)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，令 startIndex 为 0。
- 否则如果 relativeStart < 0，令 startIndex 为
max (len + relativeStart, 0)。 - 否则，令 startIndex 为
min (relativeStart, len)。 - 如果 end 为
undefined ，令 relativeEnd 为 len；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，令 endIndex 为 0。
- 否则如果 relativeEnd < 0，令 endIndex 为
max (len + relativeEnd, 0)。 - 否则，令 endIndex 为
min (relativeEnd, len)。 - 设置 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 为true ，抛出TypeError 异常。 - 设置 len 为
TypedArrayLength (taRecord)。 - 设置 endIndex 为
min (endIndex, len)。 - 令 k 为 startIndex。
- 重复，直到 k < endIndex，
- 返回 O。
23.2.3.10 %TypedArray%.prototype.filter ( callback [ , thisArg ] )
该方法的参数解释和用法与 Array.prototype.filter 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 kept 为一个新的空
List 。 - 令 captured 为 0。
- 令 k 为 0。
- 重复，直到 k < len，
- 令 A 为 ?
TypedArraySpeciesCreate (O, «𝔽 (captured) »)。 - 令 n 为 0。
- 对于 kept 的每个元素 e，执行
- 返回 A。
该方法不是泛型的。
23.2.3.11 %TypedArray%.prototype.find ( predicate [ , thisArg ] )
该方法的参数解释和用法与 Array.prototype.find 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 findRec 为 ?
FindViaPredicate (O, len,ascending , predicate, thisArg)。 - 返回 findRec.[[Value]]。
该方法不是泛型的。
23.2.3.12 %TypedArray%.prototype.findIndex ( predicate [ , thisArg ] )
该方法的参数解释和用法与 Array.prototype.findIndex 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 findRec 为 ?
FindViaPredicate (O, len,ascending , predicate, thisArg)。 - 返回 findRec.[[Index]]。
该方法不是泛型的。
23.2.3.13 %TypedArray%.prototype.findLast ( predicate [ , thisArg ] )
该方法的参数解释和用法与 Array.prototype.findLast 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 findRec 为 ?
FindViaPredicate (O, len,descending , predicate, thisArg)。 - 返回 findRec.[[Value]]。
该方法不是泛型的。
23.2.3.14 %TypedArray%.prototype.findLastIndex ( predicate [ , thisArg ] )
该方法的参数解释和用法与 Array.prototype.findLastIndex 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 findRec 为 ?
FindViaPredicate (O, len,descending , predicate, thisArg)。 - 返回 findRec.[[Index]]。
该方法不是泛型的。
23.2.3.15 %TypedArray%.prototype.forEach ( callback [ , thisArg ] )
该方法的参数解释和用法与 Array.prototype.forEach 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 k 为 0。
- 重复，直到 k < len，
- 返回
undefined 。
该方法不是泛型的。
23.2.3.16 %TypedArray%.prototype.includes ( searchElement [ , fromIndex ] )
该方法的参数解释和用法与 Array.prototype.includes 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 如果 len = 0，返回
false 。 - 令 n 为 ?
ToIntegerOrInfinity (fromIndex)。 断言 ：如果 fromIndex 为undefined ，则 n 为 0。- 如果 n = +∞，返回
false 。 - 否则如果 n = -∞，设置 n 为 0。
- 如果 n ≥ 0，则
- 令 k 为 n。
- 否则，
- 令 k 为 len + n。
- 如果 k < 0，设置 k 为 0。
- 重复，直到 k < len，
- 令 elementK 为 !
Get (O, !ToString (𝔽 (k)))。 - 如果
SameValueZero (searchElement, elementK) 为true ，返回true 。 - 设置 k 为 k + 1。
- 令 elementK 为 !
- 返回
false 。
该方法不是泛型的。
23.2.3.17 %TypedArray%.prototype.indexOf ( searchElement [ , fromIndex ] )
该方法的参数解释和用法与 Array.prototype.indexOf 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 如果 len = 0，返回
-1 𝔽。 - 令 n 为 ?
ToIntegerOrInfinity (fromIndex)。 断言 ：如果 fromIndex 为undefined ，则 n 为 0。- 如果 n = +∞，返回
-1 𝔽。 - 否则如果 n = -∞，设置 n 为 0。
- 如果 n ≥ 0，则
- 令 k 为 n。
- 否则，
- 令 k 为 len + n。
- 如果 k < 0，设置 k 为 0。
- 重复，直到 k < len，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 !
HasProperty (O, Pk)。 - 如果 kPresent 为
true ，则- 令 elementK 为 !
Get (O, Pk)。 - 如果
IsStrictlyEqual (searchElement, elementK) 为true ，返回𝔽 (k)。
- 令 elementK 为 !
- 设置 k 为 k + 1。
- 令 Pk 为 !
- 返回
-1 𝔽。
该方法不是泛型的。
23.2.3.18 %TypedArray%.prototype.join ( separator )
该方法的参数解释和用法与 Array.prototype.join 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 如果 separator 为
undefined ，令 sep 为"," 。 - 否则，令 sep 为 ?
ToString (separator)。 - 令 R 为空字符串。
- 令 k 为 0。
- 重复，直到 k < len，
- 返回 R。
该方法不是泛型的。
23.2.3.19 %TypedArray%.prototype.keys ( )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
ValidateTypedArray (O,seq-cst )。 - 返回
CreateArrayIterator (O,key )。
23.2.3.20 %TypedArray%.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
该方法的参数解释和用法与 Array.prototype.lastIndexOf 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 如果 len = 0，返回
-1 𝔽。 - 如果 fromIndex 被传入，令 n 为 ?
ToIntegerOrInfinity (fromIndex)；否则令 n 为 len - 1。 - 如果 n = -∞，返回
-1 𝔽。 - 如果 n ≥ 0，则
- 令 k 为
min (n, len - 1)。
- 令 k 为
- 否则，
- 令 k 为 len + n。
- 重复，直到 k ≥ 0，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 !
HasProperty (O, Pk)。 - 如果 kPresent 为
true ，则- 令 elementK 为 !
Get (O, Pk)。 - 如果
IsStrictlyEqual (searchElement, elementK) 为true ，返回𝔽 (k)。
- 令 elementK 为 !
- 设置 k 为 k - 1。
- 令 Pk 为 !
- 返回
-1 𝔽。
该方法不是泛型的。
23.2.3.21 get %TypedArray%.prototype.length
.prototype.length
是一个
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[TypedArrayName]])。 断言 ：O 拥有 [[ViewedArrayBuffer]] 和 [[ArrayLength]] 内部槽。- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 为true ，返回+0 𝔽。 - 令 length 为
TypedArrayLength (taRecord)。 - 返回
𝔽 (length)。
该函数不是泛型的。
23.2.3.22 %TypedArray%.prototype.map ( callback [ , thisArg ] )
该方法的参数解释和用法与 Array.prototype.map 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 A 为 ?
TypedArraySpeciesCreate (O, «𝔽 (len) »)。 - 令 k 为 0。
- 重复，直到 k < len，
- 返回 A。
该方法不是泛型的。
23.2.3.23 %TypedArray%.prototype.reduce ( callback [ , initialValue ] )
该方法的参数解释和用法与 Array.prototype.reduce 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 如果 len = 0 且未传入 initialValue，抛出
TypeError 异常。 - 令 k 为 0。
- 令 accumulator 为
undefined 。 - 如果 initialValue 被传入，则
- 将 accumulator 设为 initialValue。
- 否则，
- 重复，直到 k < len，
- 返回 accumulator。
该方法不是泛型的。
23.2.3.24 %TypedArray%.prototype.reduceRight ( callback [ , initialValue ] )
该方法的参数解释和用法与 Array.prototype.reduceRight 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 如果 len = 0 且未传入 initialValue，抛出
TypeError 异常。 - 令 k 为 len - 1。
- 令 accumulator 为
undefined 。 - 如果 initialValue 被传入，则
- 将 accumulator 设为 initialValue。
- 否则，
- 重复，直到 k ≥ 0，
- 返回 accumulator。
该方法不是泛型的。
23.2.3.25 %TypedArray%.prototype.reverse ( )
该方法的参数解释和用法与 Array.prototype.reverse 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 middle 为
floor (len / 2)。 - 令 lower 为 0。
- 重复，直到 lower ≠ middle，
- 返回 O。
该方法不是泛型的。
23.2.3.26 %TypedArray%.prototype.set ( source [ , offset ] )
该方法会在此 TypedArray 中设置多个值，从 source 读取值。具体细节取决于 source 的类型。可选的 offset 值表示在此 TypedArray 中写入值的第一个元素索引。如果省略，假定为 0。
该方法被调用时执行以下步骤：
- 令 target 为
this 值。 - 执行 ?
RequireInternalSlot (target, [[TypedArrayName]])。 断言 ：target 拥有 [[ViewedArrayBuffer]] 内部槽。- 令 targetOffset 为 ?
ToIntegerOrInfinity (offset)。 - 如果 targetOffset < 0，抛出
RangeError 异常。 - 如果 source 是带有 [[TypedArrayName]] 内部槽的
对象 ，则- 执行 ?
SetTypedArrayFromTypedArray (target, targetOffset, source)。
- 执行 ?
- 否则，
- 执行 ?
SetTypedArrayFromArrayLike (target, targetOffset, source)。
- 执行 ?
- 返回
undefined 。
该方法不是泛型的。
23.2.3.26.1 SetTypedArrayFromTypedArray ( target, targetOffset, source )
抽象操作 SetTypedArrayFromTypedArray 接收参数 target（一个
- 令 targetBuffer 为 target.[[ViewedArrayBuffer]]。
- 令 targetRecord 为
MakeTypedArrayWithBufferWitnessRecord (target,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (targetRecord) 为true ，抛出TypeError 异常。 - 令 targetLength 为
TypedArrayLength (targetRecord)。 - 令 srcBuffer 为 source.[[ViewedArrayBuffer]]。
- 令 srcRecord 为
MakeTypedArrayWithBufferWitnessRecord (source,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (srcRecord) 为true ，抛出TypeError 异常。 - 令 srcLength 为
TypedArrayLength (srcRecord)。 - 令 targetType 为
TypedArrayElementType (target)。 - 令 targetElementSize 为
TypedArrayElementSize (target)。 - 令 targetByteOffset 为 target.[[ByteOffset]]。
- 令 srcType 为
TypedArrayElementType (source)。 - 令 srcElementSize 为
TypedArrayElementSize (source)。 - 令 srcByteOffset 为 source.[[ByteOffset]]。
- 如果 targetOffset = +∞，抛出
RangeError 异常。 - 如果 srcLength + targetOffset >
targetLength，抛出
RangeError 异常。 - 如果 target.[[ContentType]] 不等于
source.[[ContentType]]，抛出
TypeError 异常。 - 如果
IsSharedArrayBuffer (srcBuffer) 为true ，IsSharedArrayBuffer (targetBuffer) 为true ，并且 srcBuffer.[[ArrayBufferData]] 等于 targetBuffer.[[ArrayBufferData]]，则令 sameSharedArrayBuffer 为true ；否则，令 sameSharedArrayBuffer 为false 。 - 如果
SameValue (srcBuffer, targetBuffer) 为true 或 sameSharedArrayBuffer 为true ，则- 令 srcByteLength 为
TypedArrayByteLength (srcRecord)。 - 将 srcBuffer 设为 ?
CloneArrayBuffer (srcBuffer, srcByteOffset, srcByteLength)。 - 令 srcByteIndex 为 0。
- 令 srcByteLength 为
- 否则，
- 令 srcByteIndex 为 srcByteOffset。
- 令 targetByteIndex 为 (targetOffset × targetElementSize) + targetByteOffset。
- 令 limit 为 targetByteIndex + (targetElementSize × srcLength)。
- 如果 srcType 等于 targetType，则
- 注：传输操作必须以保持源数据比特级编码的方式执行。
- 重复，直到 targetByteIndex < limit，
- 令 value 为
GetValueFromBuffer (srcBuffer, srcByteIndex,uint8 ,true ,unordered )。 - 执行
SetValueInBuffer (targetBuffer, targetByteIndex,uint8 , value,true ,unordered )。 - 设置 srcByteIndex 为 srcByteIndex + 1。
- 设置 targetByteIndex 为 targetByteIndex + 1。
- 令 value 为
- 否则，
- 重复，直到 targetByteIndex < limit，
- 令 value 为
GetValueFromBuffer (srcBuffer, srcByteIndex, srcType,true ,unordered )。 - 执行
SetValueInBuffer (targetBuffer, targetByteIndex, targetType, value,true ,unordered )。 - 设置 srcByteIndex 为 srcByteIndex + srcElementSize。
- 设置 targetByteIndex 为 targetByteIndex + targetElementSize。
- 令 value 为
- 重复，直到 targetByteIndex < limit，
- 返回
unused 。
23.2.3.26.2 SetTypedArrayFromArrayLike ( target, targetOffset, source )
抽象操作 SetTypedArrayFromArrayLike 接收参数 target（一个
- 令 targetRecord 为
MakeTypedArrayWithBufferWitnessRecord (target,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (targetRecord) 为true ，抛出TypeError 异常。 - 令 targetLength 为
TypedArrayLength (targetRecord)。 - 令 src 为 ?
ToObject (source)。 - 令 srcLength 为 ?
LengthOfArrayLike (src)。 - 如果 targetOffset = +∞，抛出
RangeError 异常。 - 如果 srcLength + targetOffset >
targetLength，抛出
RangeError 异常。 - 令 k 为 0。
- 重复，直到 k < srcLength，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 value 为 ?
Get (src, Pk)。 - 令 targetIndex 为
𝔽 (targetOffset + k)。 - 执行 ?
TypedArraySetElement (target, targetIndex, value)。 - 设置 k 为 k + 1。
- 令 Pk 为 !
- 返回
unused 。
23.2.3.27 %TypedArray%.prototype.slice ( start, end )
该方法的参数解释和用法与 Array.prototype.slice 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 srcArrayLength 为
TypedArrayLength (taRecord)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，令 startIndex 为 0。
- 否则如果 relativeStart < 0，令 startIndex 为
max (srcArrayLength + relativeStart, 0)。 - 否则，令 startIndex 为
min (relativeStart, srcArrayLength)。 - 如果 end 为
undefined ，令 relativeEnd 为 srcArrayLength；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，令 endIndex 为 0。
- 否则如果 relativeEnd < 0，令 endIndex 为
max (srcArrayLength + relativeEnd, 0)。 - 否则，令 endIndex 为
min (relativeEnd, srcArrayLength)。 - 令 countBytes 为
max (endIndex - startIndex, 0)。 - 令 A 为 ?
TypedArraySpeciesCreate (O, «𝔽 (countBytes) »)。 - 如果 countBytes > 0，则
- 设置 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 为true ，抛出TypeError 异常。 - 设置 endIndex 为
min (endIndex,TypedArrayLength (taRecord))。 - 设置 countBytes 为
max (endIndex - startIndex, 0)。 - 令 srcType 为
TypedArrayElementType (O)。 - 令 targetType 为
TypedArrayElementType (A)。 - 如果 srcType 等于 targetType，则
- 注：传输操作必须以保持源数据比特级编码的方式执行。
- 令 srcBuffer 为 O.[[ViewedArrayBuffer]]。
- 令 targetBuffer 为 A.[[ViewedArrayBuffer]]。
- 令 elementSize 为
TypedArrayElementSize (O)。 - 令 srcByteOffset 为 O.[[ByteOffset]]。
- 令 srcByteIndex 为 (startIndex × elementSize) + srcByteOffset。
- 令 targetByteIndex 为 A.[[ByteOffset]]。
- 令 endByteIndex 为 targetByteIndex + (countBytes × elementSize)。
- 重复，直到 targetByteIndex <
endByteIndex，
- 令 value 为
GetValueFromBuffer (srcBuffer, srcByteIndex,uint8 ,true ,unordered )。 - 执行
SetValueInBuffer (targetBuffer, targetByteIndex,uint8 , value,true ,unordered )。 - 设置 srcByteIndex 为 srcByteIndex + 1。
- 设置 targetByteIndex 为 targetByteIndex + 1。
- 令 value 为
- 否则，
- 设置 taRecord 为
- 返回 A。
该方法不是泛型的。
23.2.3.28 %TypedArray%.prototype.some ( callback [ , thisArg ] )
该方法的参数解释和用法与 Array.prototype.some 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 k 为 0。
- 重复，直到 k < len，
- 返回
false 。
该方法不是泛型的。
23.2.3.29 %TypedArray%.prototype.sort ( comparator )
这是一个不同的方法，除下述说明外，其实现要求与 Array.prototype.sort 相同。该方法的实现可以利用
该方法不是泛型的。
该方法被调用时执行以下步骤：
- 如果 comparator 不为
undefined 且IsCallable (comparator) 为false ，抛出TypeError 异常。 - 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 注：以下闭包执行数值比较，而不是
23.1.3.30 中使用的字符串比较。 - 令 SortCompare 为一个新的
抽象闭包 ，带参数 (x, y)，捕获 comparator 并在调用时执行以下步骤：- 返回 ?
CompareTypedArrayElements (x, y, comparator)。
- 返回 ?
- 令 sortedList 为 ?
SortIndexedProperties (obj, len, SortCompare,read-through-holes )。 - 令 j 为 0。
- 重复，直到 j < len，
- 返回 obj。
由于
23.2.3.30 %TypedArray%.prototype.subarray ( start, end )
该方法返回一个新的 TypedArray，其元素类型与此 TypedArray 的元素类型相同，ArrayBuffer 也与此 TypedArray 相同，引用 start（包含）到 end（不包含）区间内的元素。如果 start 或 end 为负数，则它表示从数组末尾开始的索引，而不是从头开始。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[TypedArrayName]])。 断言 ： O 拥有 [[ViewedArrayBuffer]] 内部槽。- 令 buffer 为 O.[[ViewedArrayBuffer]]。
- 令 srcRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (srcRecord) 为true ，则- 令 srcLength 为 0。
- 否则，
- 令 srcLength 为
TypedArrayLength (srcRecord)。
- 令 srcLength 为
- 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，令 startIndex 为 0。
- 否则如果 relativeStart < 0，令 startIndex 为
max (srcLength + relativeStart, 0)。 - 否则，令 startIndex 为
min (relativeStart, srcLength)。 - 令 elementSize 为
TypedArrayElementSize (O)。 - 令 srcByteOffset 为 O.[[ByteOffset]]。
- 令 beginByteOffset 为 srcByteOffset + (startIndex × elementSize)。
- 如果 O.[[ArrayLength]] 为
auto 且 end 为undefined ，则- 令 argumentsList 为 « buffer,
𝔽 (beginByteOffset) »。
- 令 argumentsList 为 « buffer,
- 否则，
- 如果 end 为
undefined ，令 relativeEnd 为 srcLength；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，令 endIndex 为 0。
- 否则如果 relativeEnd < 0，令 endIndex 为
max (srcLength + relativeEnd, 0)。 - 否则，令 endIndex 为
min (relativeEnd, srcLength)。 - 令 newLength 为
max (endIndex - startIndex, 0)。 - 令 argumentsList 为 « buffer,
𝔽 (beginByteOffset),𝔽 (newLength) »。
- 如果 end 为
- 返回 ?
TypedArraySpeciesCreate (O, argumentsList)。
该方法不是泛型的。
23.2.3.31 %TypedArray%.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
这是一个不同的方法，其实现算法与 Array.prototype.toLocaleString 相同，只是用
该方法不是泛型的。调用算法前会用
如果 ECMAScript 实现包含 ECMA-402 国际化 API，则该方法基于 ECMA-402 规范中的
Array.prototype.toLocaleString 算法。
23.2.3.32 %TypedArray%.prototype.toReversed ( )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 A 为 ?
TypedArrayCreateSameType (O, «𝔽 (length) »)。 - 令 k 为 0。
- 重复，直到 k < length，
- 返回 A。
23.2.3.33 %TypedArray%.prototype.toSorted ( comparator )
该方法被调用时执行以下步骤：
- 如果 comparator 不为
undefined 且IsCallable (comparator) 为false ，抛出TypeError 异常。 - 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 A 为 ?
TypedArrayCreateSameType (O, «𝔽 (len) »)。 - 注：以下闭包执行数值比较，而不是
23.1.3.34 中使用的字符串比较。 - 令 SortCompare 为一个新的
抽象闭包 ，带参数 (x, y)，捕获 comparator 并在调用时执行以下步骤：- 返回 ?
CompareTypedArrayElements (x, y, comparator)。
- 返回 ?
- 令 sortedList 为 ?
SortIndexedProperties (O, len, SortCompare,read-through-holes )。 - 令 j 为 0。
- 重复，直到 j < len，
- 返回 A。
23.2.3.34 %TypedArray%.prototype.toString ( )
23.2.3.35 %TypedArray%.prototype.values ( )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
ValidateTypedArray (O,seq-cst )。 - 返回
CreateArrayIterator (O,value )。
23.2.3.36 %TypedArray%.prototype.with ( index, value )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 如果 relativeIndex ≥ 0，令 actualIndex 为 relativeIndex。
- 否则，令 actualIndex 为 len + relativeIndex。
- 如果 O.[[ContentType]] 为
bigint ，令 numericValue 为 ?ToBigInt (value)。 - 否则，令 numericValue 为 ?
ToNumber (value)。 - 如果
IsValidIntegerIndex (O,𝔽 (actualIndex)) 为false ，抛出RangeError 异常。 - 令 A 为 ?
TypedArrayCreateSameType (O, «𝔽 (len) »)。 - 令 k 为 0。
- 重复，直到 k < len，
- 返回 A。
23.2.3.37 %TypedArray%.prototype [ %Symbol.iterator% ] ( )
23.2.3.38 get %TypedArray%.prototype [ %Symbol.toStringTag% ]
.prototype[%Symbol.toStringTag%]
是一个
该属性具有属性 { [[Enumerable]]:
该函数的
23.2.4 TypedArray 对象的抽象操作
23.2.4.1 TypedArraySpeciesCreate ( exemplar, argumentList )
抽象操作 TypedArraySpeciesCreate 接收参数 exemplar（一个
- 令 defaultConstructor 为
表 75 中与 exemplar.[[TypedArrayName]] 同名的内建对象。 - 令 constructor 为 ?
SpeciesConstructor (exemplar, defaultConstructor)。 - 令 result 为 ?
TypedArrayCreateFromConstructor (constructor, argumentList)。 断言 ： result 拥有 [[TypedArrayName]] 和 [[ContentType]] 内部槽。- 如果 result.[[ContentType]] 不等于
exemplar.[[ContentType]]，抛出
TypeError 异常。 - 返回 result。
23.2.4.2 TypedArrayCreateFromConstructor ( constructor, argumentList )
抽象操作 TypedArrayCreateFromConstructor 接收参数 constructor（一个
- 令 newTypedArray 为 ?
Construct (constructor, argumentList)。 - 令 taRecord 为 ?
ValidateTypedArray (newTypedArray,seq-cst )。 - 如果 argumentList 的元素数量为 1 且 argumentList[0]
是数字 ，则- 如果
IsTypedArrayOutOfBounds (taRecord) 为true ，抛出TypeError 异常。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果 length <
ℝ (argumentList[0])，抛出TypeError 异常。
- 如果
- 返回 newTypedArray。
23.2.4.3 TypedArrayCreateSameType ( exemplar, argumentList )
抽象操作 TypedArrayCreateSameType 接收参数 exemplar（一个
- 令 constructor 为
表 75 中与 exemplar.[[TypedArrayName]] 同名的内建对象。 - 令 result 为 ?
TypedArrayCreateFromConstructor (constructor, argumentList)。 断言 ： result 拥有 [[TypedArrayName]] 和 [[ContentType]] 内部槽。断言 ： result.[[ContentType]] 等于 exemplar.[[ContentType]]。- 返回 result。
23.2.4.4 ValidateTypedArray ( O, order )
抽象操作 ValidateTypedArray 接收参数 O（一个
- 执行 ?
RequireInternalSlot (O, [[TypedArrayName]])。 断言 ： O 拥有 [[ViewedArrayBuffer]] 内部槽。- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O, order)。 - 如果
IsTypedArrayOutOfBounds (taRecord) 为true ，抛出TypeError 异常。 - 返回 taRecord。
23.2.4.5 TypedArrayElementSize ( O )
抽象操作 TypedArrayElementSize 接收参数 O（一个
- 返回
表 75 中 O.[[TypedArrayName]] 指定的元素大小值。
23.2.4.6 TypedArrayElementType ( O )
抽象操作 TypedArrayElementType 接收参数 O（一个
- 返回
表 75 中 O.[[TypedArrayName]] 指定的元素类型值。
23.2.4.7 CompareTypedArrayElements ( x, y, comparator )
抽象操作 CompareTypedArrayElements 接收参数 x（一个 Number 或 BigInt）、y（一个 Number 或
BigInt）、comparator（一个
23.2.5 TypedArray 构造函数
每个 TypedArray
- 是一个内建对象，结构如下所述，唯一的区别是
构造函数 名称不同于 TypedArray，见表 75 。 - 是一个函数，其行为会根据参数的数量和类型而异。对 TypedArray 的实际调用行为取决于传递给它的参数数量和类型。
- 不应作为普通函数调用，否则会抛出异常。
- 可以用作类定义的
extends子句的值。想要继承指定 TypedArray 行为的子类构造函数 必须包含对 TypedArray构造函数 的super调用，以用必要的内部状态创建和初始化子类实例，以支持%TypedArray% .prototype内建方法。
23.2.5.1 TypedArray ( ...args )
每个 TypedArray
- 如果 NewTarget 为
undefined ，抛出TypeError 异常。 - 令 constructorName 为
表 75 中为此 TypedArray构造函数 指定的构造函数 名称的字符串值。 - 令 proto 为
"%TypedArray.prototype%"。 - 令 numberOfArgs 为 args 的元素数量。
- 如果 numberOfArgs = 0，则
- 返回 ?
AllocateTypedArray (constructorName, NewTarget, proto, 0)。
- 返回 ?
- 否则，
- 令 firstArgument 为 args[0]。
- 如果 firstArgument
是对象 ，则- 令 O 为 ?
AllocateTypedArray (constructorName, NewTarget, proto)。 - 如果 firstArgument 有 [[TypedArrayName]] 内部槽，则
- 执行 ?
InitializeTypedArrayFromTypedArray (O, firstArgument)。
- 执行 ?
- 否则如果 firstArgument 有 [[ArrayBufferData]] 内部槽，则
- 如果 numberOfArgs > 1，令 byteOffset 为
args[1]；否则令 byteOffset 为
undefined 。 - 如果 numberOfArgs > 2，令 length 为
args[2]；否则令 length 为
undefined 。 - 执行 ?
InitializeTypedArrayFromArrayBuffer (O, firstArgument, byteOffset, length)。
- 如果 numberOfArgs > 1，令 byteOffset 为
args[1]；否则令 byteOffset 为
- 否则，
断言 ： firstArgument是对象 且 firstArgument 没有 [[TypedArrayName]] 或 [[ArrayBufferData]] 内部槽。- 令 usingIterator 为 ?
GetMethod (firstArgument,%Symbol.iterator% )。 - 如果 usingIterator 不为
undefined ，则- 令 values 为 ?
IteratorToList (?GetIteratorFromMethod (firstArgument, usingIterator))。 - 执行 ?
InitializeTypedArrayFromList (O, values)。
- 令 values 为 ?
- 否则，
- 注：firstArgument 不是
可迭代对象 ，所以假定它已经是类数组对象 。 - 执行 ?
InitializeTypedArrayFromArrayLike (O, firstArgument)。
- 注：firstArgument 不是
- 返回 O。
- 令 O 为 ?
- 否则，
断言 ： firstArgument不是对象 。- 令 elementLength 为 ?
ToIndex (firstArgument)。 - 返回 ?
AllocateTypedArray (constructorName, NewTarget, proto, elementLength)。
23.2.5.1.1 AllocateTypedArray ( constructorName, newTarget, defaultProto [ , length ] )
抽象操作 AllocateTypedArray 接收参数 constructorName（一个字符串，为
- 令 proto 为 ?
GetPrototypeFromConstructor (newTarget, defaultProto)。 - 令 obj 为
TypedArrayCreate (proto)。 断言 ：obj.[[ViewedArrayBuffer]] 为undefined 。- 设置 obj.[[TypedArrayName]] 为 constructorName。
- 如果 constructorName 是
"BigInt64Array" 或"BigUint64Array" ，将 obj.[[ContentType]] 设为bigint 。 - 否则，将 obj.[[ContentType]] 设为
number 。 - 如果未传入 length，则
- 设置 obj.[[ByteLength]] 为 0。
- 设置 obj.[[ByteOffset]] 为 0。
- 设置 obj.[[ArrayLength]] 为 0。
- 否则，
- 执行 ?
AllocateTypedArrayBuffer (obj, length)。
- 执行 ?
- 返回 obj。
23.2.5.1.2 InitializeTypedArrayFromTypedArray ( O, srcArray )
抽象操作 InitializeTypedArrayFromTypedArray 接收参数 O（一个
- 令 srcData 为 srcArray.[[ViewedArrayBuffer]]。
- 令 elementType 为
TypedArrayElementType (O)。 - 令 elementSize 为
TypedArrayElementSize (O)。 - 令 srcType 为
TypedArrayElementType (srcArray)。 - 令 srcElementSize 为
TypedArrayElementSize (srcArray)。 - 令 srcByteOffset 为 srcArray.[[ByteOffset]]。
- 令 srcRecord 为
MakeTypedArrayWithBufferWitnessRecord (srcArray,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (srcRecord) 为true ，抛出TypeError 异常。 - 令 elementLength 为
TypedArrayLength (srcRecord)。 - 令 byteLength 为 elementSize × elementLength。
- 如果 elementType 等于 srcType，则
- 令 data 为 ?
CloneArrayBuffer (srcData, srcByteOffset, byteLength)。
- 令 data 为 ?
- 否则，
- 令 data 为 ?
AllocateArrayBuffer (%ArrayBuffer% , byteLength)。 - 如果 srcArray.[[ContentType]] 不等于
O.[[ContentType]]，抛出
TypeError 异常。 - 令 srcByteIndex 为 srcByteOffset。
- 令 targetByteIndex 为 0。
- 令 count 为 elementLength。
- 重复，直到 count > 0，
- 令 value 为
GetValueFromBuffer (srcData, srcByteIndex, srcType,true ,unordered )。 - 执行
SetValueInBuffer (data, targetByteIndex, elementType, value,true ,unordered )。 - 设置 srcByteIndex 为 srcByteIndex + srcElementSize。
- 设置 targetByteIndex 为 targetByteIndex + elementSize。
- 设置 count 为 count - 1。
- 令 value 为
- 令 data 为 ?
- 设置 O.[[ViewedArrayBuffer]] 为 data。
- 设置 O.[[ByteLength]] 为 byteLength。
- 设置 O.[[ByteOffset]] 为 0。
- 设置 O.[[ArrayLength]] 为 elementLength。
- 返回
unused 。
23.2.6 TypedArray 构造函数的属性
每个 TypedArray
- 拥有一个 [[Prototype]] 内部槽，其值为
%TypedArray% 。 - 有一个
"length" 属性，其值为3 𝔽。 - 有一个
"name" 属性，其值为构造函数 在表 75 中为其指定的字符串值。 - 拥有以下属性：
23.2.6.1 TypedArray.BYTES_PER_ELEMENT
TypedArray.BYTES_PER_ELEMENT 的值为
该属性具有属性 { [[Writable]]:
23.2.6.2 TypedArray.prototype
TypedArray.prototype 的初始值为对应的 TypedArray 原型内建对象（
该属性具有属性 { [[Writable]]:
23.2.7 TypedArray 原型对象的属性
每个 TypedArray 原型对象：
- 拥有一个 [[Prototype]] 内部槽，其值为
%TypedArray.prototype% 。 - 是一个
普通对象 。 - 没有 [[ViewedArrayBuffer]] 或其它 TypedArray 实例对象专有的内部槽。
23.2.7.1 TypedArray.prototype.BYTES_PER_ELEMENT
TypedArray.prototype.BYTES_PER_ELEMENT 的值为
该属性具有属性 { [[Writable]]:
23.2.7.2 TypedArray.prototype.constructor
23.2.8 TypedArray 实例的属性
TypedArray 实例是
24 键控集合
24.1 Map 对象
Map 是一种键/值对集合，其中键和值都可以是任意的
Map 必须通过哈希表或其他机制实现，这些机制平均而言可以提供次线性的元素访问时间。本规范中所用的数据结构仅用于描述 Map 所需的可观察语义，而不是可行的实现模型。
24.1.1 Map 构造函数
Map
- 即 %Map%。
- 是
全局对象 的"Map" 属性的初始值。 - 作为
构造函数 调用时会创建并初始化一个新的 Map。 - 不应作为普通函数调用，否则会抛出异常。
- 可以用作类定义的
extends子句的值。想要继承指定 Map 行为的子类构造函数 必须包含对 Map构造函数 的super调用，以用必要的内部状态创建和初始化子类实例，以支持Map.prototype内建方法。
24.1.1.1 Map ( [ iterable ] )
该函数被调用时执行以下步骤：
- 如果 NewTarget 为
undefined ，抛出TypeError 异常。 - 令 map 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Map.prototype%" , « [[MapData]] »)。 - 设置 map.[[MapData]] 为一个新的空
List 。 - 如果 iterable 为
undefined 或null ，返回 map。 - 令 adder 为 ?
Get (map,"set" )。 - 如果
IsCallable (adder) 为false ，抛出TypeError 异常。 - 返回 ?
AddEntriesFromIterable (map, iterable, adder)。
如果参数 iterable 存在，期望它是一个实现了
24.1.1.2 AddEntriesFromIterable ( target, iterable, adder )
抽象操作 AddEntriesFromIterable 接收参数 target（一个对象）、iterable（
- 令 iteratorRecord 为 ?
GetIterator (iterable,sync )。 - 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 为
done ，返回 target。 - 如果 next
不是对象 ，则- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iteratorRecord, error)。
- 令 error 为
- 令 k 为
Completion (Get (next,"0" ))。 IfAbruptCloseIterator (k, iteratorRecord)。- 令 v 为
Completion (Get (next,"1" ))。 IfAbruptCloseIterator (v, iteratorRecord)。- 令 status 为
Completion (Call (adder, target, « k, v »))。 IfAbruptCloseIterator (status, iteratorRecord)。
- 令 next 为 ?
参数 iterable 期望是一个实现了
24.1.2 Map 构造函数的属性
Map
- 拥有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 拥有以下属性：
24.1.2.1 Map.groupBy ( items, callback )
callback 应该是一个接受两个参数的函数。groupBy 会按照升序对 items
中的每个元素调用 callback 一次，并构造一个新的 Map。每个 callback 返回的值会作为 Map
的键。对于每个这样的键，结果 Map 有一个键为该键、值为包含所有 callback 返回该键的元素的数组的条目。
callback 的两个参数分别是元素的值和索引。
groupBy 的返回值是一个 Map。
该函数被调用时执行以下步骤：
24.1.2.2 Map.prototype
Map.prototype 的初始值为
该属性具有属性 { [[Writable]]:
24.1.2.3 get Map [ %Symbol.species% ]
Map[%Symbol.species%] 是一个
- 返回
this 值。
该函数的
创建派生集合对象的方法应当调用
24.1.3 Map 原型对象的属性
Map 原型对象：
- 即 %Map.prototype%。
- 拥有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是一个
普通对象 。 - 没有 [[MapData]] 内部槽。
24.1.3.1 Map.prototype.clear ( )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 对于 M.[[MapData]] 中的每个
Record { [[Key]], [[Value]] } p，执行- 将 p.[[Key]] 设为
empty 。 - 将 p.[[Value]] 设为
empty 。
- 将 p.[[Key]] 设为
- 返回
undefined 。
24.1.3.2 Map.prototype.constructor
Map.prototype.constructor 的初始值为
24.1.3.3 Map.prototype.delete ( key )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 将 key 设为
CanonicalizeKeyedCollectionKey (key)。 - 对于 M.[[MapData]] 中的每个
Record { [[Key]], [[Value]] } p，执行- 如果 p.[[Key]] 不为
empty 且SameValue (p.[[Key]], key) 为true ，则- 将 p.[[Key]] 设为
empty 。 - 将 p.[[Value]] 设为
empty 。 - 返回
true 。
- 将 p.[[Key]] 设为
- 如果 p.[[Key]] 不为
- 返回
false 。
24.1.3.4 Map.prototype.entries ( )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 返回 ?
CreateMapIterator (M,key+value )。
24.1.3.5 Map.prototype.forEach ( callback [ , thisArg ] )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 entries 为 M.[[MapData]]。
- 令 numEntries 为 entries 的元素个数。
- 令 index 为 0。
- 重复，直到 index < numEntries，
- 令 e 为 entries[index]。
- 设置 index 为 index + 1。
- 如果 e.[[Key]] 不为
empty ，则- 执行 ?
Call (callback, thisArg, « e.[[Value]], e.[[Key]], M »)。 - 注：在 callback 执行期间 entries 的元素数量可能增加。
- 设置 numEntries 为 entries 的当前元素数量。
- 执行 ?
- 返回
undefined 。
callback 应该是一个接受三个参数的函数。forEach 会按照键的插入顺序对 Map 中每个键/值对调用
callback 一次。只有实际存在的 Map 键才会被调用 callback；已被删除的键不会被调用。
如果提供了 thisArg 参数，则该参数会作为每次调用 callback 时的
callback 的三个参数分别是项的值、项的键，以及被遍历的 Map。
forEach 本身不会直接修改被调用对象，但该对象可能会被 callback 的调用修改。map 的 [[MapData]] 的每个条目只会被访问一次。在 forEach
开始后添加的新键会被访问。如果某个键被访问后被删除并在 forEach 完成前重新添加，则该键会被再次访问。在
forEach 开始后但被访问前被删除的键不会被访问，除非该键在 forEach 完成前被再次添加。
24.1.3.6 Map.prototype.get ( key )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 将 key 设为
CanonicalizeKeyedCollectionKey (key)。 - 对于 M.[[MapData]] 中的每个
Record { [[Key]], [[Value]] } p，执行- 如果 p.[[Key]] 不为
empty 且SameValue (p.[[Key]], key) 为true ，返回 p.[[Value]]。
- 如果 p.[[Key]] 不为
- 返回
undefined 。
24.1.3.7 Map.prototype.has ( key )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 将 key 设为
CanonicalizeKeyedCollectionKey (key)。 - 对于 M.[[MapData]] 中的每个
Record { [[Key]], [[Value]] } p，执行- 如果 p.[[Key]] 不为
empty 且SameValue (p.[[Key]], key) 为true ，返回true 。
- 如果 p.[[Key]] 不为
- 返回
false 。
24.1.3.8 Map.prototype.keys ( )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 返回 ?
CreateMapIterator (M,key )。
24.1.3.9 Map.prototype.set ( key, value )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 将 key 设为
CanonicalizeKeyedCollectionKey (key)。 - 对于 M.[[MapData]] 中的每个
Record { [[Key]], [[Value]] } p，执行- 如果 p.[[Key]] 不为
empty 且SameValue (p.[[Key]], key) 为true ，则- 将 p.[[Value]] 设为 value。
- 返回 M。
- 如果 p.[[Key]] 不为
- 令 p 为
Record { [[Key]]: key, [[Value]]: value }。 - 将 p 添加到 M.[[MapData]]。
- 返回 M。
24.1.3.10 get Map.prototype.size
Map.prototype.size 是一个
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 令 count 为 0。
- 对于 M.[[MapData]] 中的每个
Record { [[Key]], [[Value]] } p，执行- 如果 p.[[Key]] 不为
empty ，则将 count 设为 count + 1。
- 如果 p.[[Key]] 不为
- 返回
𝔽 (count)。
24.1.3.11 Map.prototype.values ( )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 返回 ?
CreateMapIterator (M,value )。
24.1.3.12 Map.prototype [ %Symbol.iterator% ] ( )
24.1.3.13 Map.prototype [ %Symbol.toStringTag% ]
该属性具有属性 { [[Writable]]:
24.1.4 Map 实例的属性
Map 实例是
24.1.5 Map 迭代器对象
Map
迭代器 是一个表示对某个特定 Map 实例对象的特定遍历的对象。Map 迭代器对象没有具名的
24.1.5.1 CreateMapIterator ( map, kind )
抽象操作 CreateMapIterator 接收参数 map（一个
- 执行 ?
RequireInternalSlot (map, [[MapData]])。 - 令 closure 为一个新的
抽象闭包 ，无参数，捕获 map 和 kind，调用时执行以下步骤：- 令 entries 为 map.[[MapData]]。
- 令 index 为 0。
- 令 numEntries 为 entries 的元素数量。
- 重复，直到 index < numEntries，
- 令 e 为 entries[index]。
- 设置 index 为 index + 1。
- 如果 e.[[Key]] 不为
empty ，则- 如果 kind 是
key ，则- 令 result 为 e.[[Key]]。
- 否则如果 kind 是
value ，则- 令 result 为 e.[[Value]]。
- 否则，
断言 ：kind 是key+value 。- 令 result 为
CreateArrayFromList (« e.[[Key]], e.[[Value]] »)。
- 执行 ?
GeneratorYield (CreateIteratorResultObject (result,false ))。 - 注：在
GeneratorYield 挂起本抽象操作执行期间，entries 的元素数量可能增加。 - 设置 numEntries 为 entries 的元素数量。
- 如果 kind 是
- 返回
undefined 。
- 返回
CreateIteratorFromClosure (closure,"%MapIteratorPrototype%" ,%MapIteratorPrototype% )。
24.1.5.2 %MapIteratorPrototype% 对象
%MapIteratorPrototype% 对象：
- 拥有所有
Map 迭代器对象 可继承的属性。 - 是一个
普通对象 。 - 拥有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 拥有以下属性：
24.1.5.2.1 %MapIteratorPrototype%.next ( )
- 返回 ?
GeneratorResume (this 值,empty ,"%MapIteratorPrototype%" )。
24.1.5.2.2 %MapIteratorPrototype% [ %Symbol.toStringTag% ]
该属性具有特性 { [[Writable]]:
24.2 Set 对象
Set 对象是
Set 对象必须通过哈希表或其他机制实现，这些机制在平均情况下能提供次线性的元素访问时间。本规范中所用的数据结构仅用于描述 Set 对象所需的可观察语义，而非实际的实现模型。
24.2.1 Set 对象的抽象操作
24.2.1.1 Set 记录
Set 记录是一个
Set 记录具有
24.2.1.2 GetSetRecord ( obj )
抽象操作 GetSetRecord 接收参数 obj（一个
- 如果 obj
不是对象 ，抛出TypeError 异常。 - 令 rawSize 为 ?
Get (obj,"size" )。 - 令 numSize 为 ?
ToNumber (rawSize)。 - 注：如果 rawSize 为
undefined ，则 numSize 会是NaN 。 - 如果 numSize 为
NaN ，抛出TypeError 异常。 - 令 intSize 为 !
ToIntegerOrInfinity (numSize)。 - 如果 intSize < 0，抛出
RangeError 异常。 - 令 has 为 ?
Get (obj,"has" )。 - 如果
IsCallable (has) 为false ，抛出TypeError 异常。 - 令 keys 为 ?
Get (obj,"keys" )。 - 如果
IsCallable (keys) 为false ，抛出TypeError 异常。 - 返回一个新的
Set 记录 { [[SetObject]]: obj, [[Size]]: intSize, [[Has]]: has, [[Keys]]: keys }。
24.2.1.3 SetDataHas ( setData, value )
抽象操作 SetDataHas 接收参数 setData（一个
- 如果
SetDataIndex (setData, value) 为not-found ，返回false 。 - 返回
true 。
24.2.1.4 SetDataIndex ( setData, value )
抽象操作 SetDataIndex 接收参数 setData（一个
- 将 value 设为
CanonicalizeKeyedCollectionKey (value)。 - 令 size 为 setData 的元素数量。
- 令 index 为 0。
- 重复，直到 index < size，
- 令 e 为 setData[index]。
- 如果 e 不为
empty 且 e 等于 value，则- 返回 index。
- 将 index 设为 index + 1。
- 返回
not-found 。
24.2.1.5 SetDataSize ( setData )
抽象操作 SetDataSize 接收参数 setData（一个
- 令 count 为 0。
- 对于 setData 的每个元素 e，执行
- 如果 e 不为
empty ，将 count 设为 count + 1。
- 如果 e 不为
- 返回 count。
24.2.2 Set 构造函数
Set
- 即 %Set%。
- 是
全局对象 的"Set" 属性的初始值。 - 作为
构造函数 调用时会创建并初始化一个新的 Set 对象。 - 不应作为普通函数调用，否则会抛出异常。
- 可以用作类定义的
extends子句的值。想要继承指定 Set 行为的子类构造函数 必须包含对 Set构造函数 的super调用，以用必要的内部状态创建和初始化子类实例，以支持Set.prototype内建方法。
24.2.2.1 Set ( [ iterable ] )
该函数被调用时执行以下步骤：
- 如果 NewTarget 为
undefined ，抛出TypeError 异常。 - 令 set 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Set.prototype%" , « [[SetData]] »)。 - 设置 set.[[SetData]] 为一个新的空
List 。 - 如果 iterable 为
undefined 或null ，返回 set。 - 令 adder 为 ?
Get (set,"add" )。 - 如果
IsCallable (adder) 为false ，抛出TypeError 异常。 - 令 iteratorRecord 为 ?
GetIterator (iterable,sync )。 - 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 为
done ，返回 set。 - 令 status 为
Completion (Call (adder, set, « next »))。 IfAbruptCloseIterator (status, iteratorRecord)。
- 令 next 为 ?
24.2.3 Set 构造函数的属性
Set
- 拥有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 拥有以下属性：
24.2.3.1 Set.prototype
Set.prototype 的初始值为
该属性具有属性 { [[Writable]]:
24.2.3.2 get Set [ %Symbol.species% ]
Set[%Symbol.species%] 是一个
- 返回
this 值。
该函数的
创建派生集合对象的方法应当调用
24.2.4 Set 原型对象的属性
Set 原型对象：
- 即 %Set.prototype%。
- 拥有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是一个
普通对象 。 - 没有 [[SetData]] 内部槽。
24.2.4.1 Set.prototype.add ( value )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[SetData]]). - 将 value 设为
CanonicalizeKeyedCollectionKey (value)。 - 对于 S.[[SetData]] 的每个元素 e，执行
- 如果 e 不为
empty 且SameValue (e, value) 为true ，则- 返回 S。
- 如果 e 不为
- 将 value 添加到 S.[[SetData]]。
- 返回 S。
24.2.4.2 Set.prototype.clear ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[SetData]]). - 对于 S.[[SetData]] 的每个元素 e，执行
- 将 S.[[SetData]] 中值为 e
的元素替换为值为
empty 的元素。
- 将 S.[[SetData]] 中值为 e
的元素替换为值为
- 返回
undefined 。
24.2.4.3 Set.prototype.constructor
Set.prototype.constructor 的初始值为
24.2.4.4 Set.prototype.delete ( value )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[SetData]]). - 将 value 设为
CanonicalizeKeyedCollectionKey (value)。 - 对于 S.[[SetData]] 的每个元素 e，执行
- 如果 e 不为
empty 且SameValue (e, value) 为true ，则- 将 S.[[SetData]] 中值为 e
的元素替换为值为
empty 的元素。 - 返回
true 。
- 将 S.[[SetData]] 中值为 e
的元素替换为值为
- 如果 e 不为
- 返回
false 。
24.2.4.5 Set.prototype.difference ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]]). - 令 otherRec 为 ?
GetSetRecord (other)。 - 令 resultSetData 为 O.[[SetData]] 的一个副本。
- 如果
SetDataSize (O.[[SetData]]) ≤ otherRec.[[Size]]，则 - 否则，
- 令 keysIter 为 ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]])。 - 令 next 为
not-started 。 - 重复，直到 next 不为
done ，- 将 next 设为 ?
IteratorStepValue (keysIter)。 - 如果 next 不为
done ，则- 将 next 设为
CanonicalizeKeyedCollectionKey (next)。 - 令 valueIndex 为
SetDataIndex (resultSetData, next)。 - 如果 valueIndex 不为
not-found ，则- 将 resultSetData[valueIndex] 设为
empty 。
- 将 resultSetData[valueIndex] 设为
- 将 next 设为
- 将 next 设为 ?
- 令 keysIter 为 ?
- 令 result 为
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)。 - 设置 result.[[SetData]] 为 resultSetData。
- 返回 result。
24.2.4.6 Set.prototype.entries ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateSetIterator (S,key+value )。
对于遍历目的，Set 类似于每个条目的键和值都相同的 Map。
24.2.4.7 Set.prototype.forEach ( callback [ , thisArg ] )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[SetData]])。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 entries 为 S.[[SetData]]。
- 令 numEntries 为 entries 的元素数量。
- 令 index 为 0。
- 重复，直到 index < numEntries，
- 令 e 为 entries[index]。
- 设置 index 为 index + 1。
- 如果 e 不为
empty ，则- 执行 ?
Call (callback, thisArg, « e, e, S »)。 - 注：在 callback 执行期间 entries 的数量可能增加。
- 设置 numEntries 为 entries 的当前元素数量。
- 执行 ?
- 返回
undefined 。
callback 应该是一个接受三个参数的函数。forEach 会按照值插入顺序对 Set 对象中每个存在的值调用
callback 一次。只有实际存在的 Set 值才会被调用 callback；已被删除的键不会被调用。
如果提供了 thisArg 参数，则其会用作每次调用 callback 时的
callback 会被传入三个参数：前两个参数是 Set 中包含的同一个值，第三个参数是正在遍历的 Set 对象。
回调函数采用三个参数是为了与 Map 和 Array 的 forEach 方法的回调一致。对于 Set，每个元素既视为键又视为值。
forEach 本身不会直接修改被调用对象，但该对象可能会被 callback 的调用修改。
每个值通常只会被访问一次。不过，如果某个值被访问后被删除并在 forEach 完成前重新添加，则该值会被再次访问。在
forEach 开始后但被访问前被删除的值不会被访问，除非该值在 forEach 完成前被再次添加。在
forEach 开始后添加的新值会被访问。
24.2.4.8 Set.prototype.has ( value )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[SetData]])。 - 将 value 设为
CanonicalizeKeyedCollectionKey (value)。 - 对于 S.[[SetData]] 的每个元素 e，执行
- 如果 e 不为
empty 且SameValue (e, value) 为true ，返回true 。
- 如果 e 不为
- 返回
false 。
24.2.4.9 Set.prototype.intersection ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 令 resultSetData 为一个新的空
List 。 - 如果
SetDataSize (O.[[SetData]]) ≤ otherRec.[[Size]]，则- 令 thisSize 为 O.[[SetData]] 的元素数量。
- 令 index 为 0。
- 重复，直到 index < thisSize，
- 令 e 为 O.[[SetData]][index]。
- 设置 index 为 index + 1。
- 如果 e 不为
empty ，则- 令 inOther 为
ToBoolean (?Call (otherRec.[[Has]], otherRec.[[SetObject]], « e »))。 - 如果 inOther 为
true ，则- 注：较早对 otherRec.[[Has]] 的调用可能会移除并重新添加 O.[[SetData]] 的元素，这可能导致同一元素在本遍历中被访问两次。
- 如果
SetDataHas (resultSetData, e) 为false ，则- 将 e 添加到 resultSetData。
- 注：在 otherRec.[[Has]] 执行期间，O.[[SetData]] 的元素数量可能增加。
- 设置 thisSize 为 O.[[SetData]] 的当前元素数量。
- 令 inOther 为
- 否则，
- 令 keysIter 为 ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]])。 - 令 next 为
not-started 。 - 重复，直到 next 不为
done ，- 将 next 设为 ?
IteratorStepValue (keysIter)。 - 如果 next 不为
done ，则- 将 next 设为
CanonicalizeKeyedCollectionKey (next)。 - 令 inThis 为
SetDataHas (O.[[SetData]], next)。 - 如果 inThis 为
true ，则- 注：由于 other 是任意对象，其
"keys" 迭代器 可能会多次产出同一值。 - 如果
SetDataHas (resultSetData, next) 为false ，则- 将 next 添加到 resultSetData。
- 注：由于 other 是任意对象，其
- 将 next 设为
- 将 next 设为 ?
- 令 keysIter 为 ?
- 令 result 为
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)。 - 设置 result.[[SetData]] 为 resultSetData。
- 返回 result。
24.2.4.10 Set.prototype.isDisjointFrom ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 如果
SetDataSize (O.[[SetData]]) ≤ otherRec.[[Size]]，则- 令 thisSize 为 O.[[SetData]] 的元素数量。
- 令 index 为 0。
- 重复，直到 index < thisSize，
- 否则，
- 令 keysIter 为 ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]])。 - 令 next 为
not-started 。 - 重复，直到 next 不为
done ，- 将 next 设为 ?
IteratorStepValue (keysIter)。 - 如果 next 不为
done ，则- 如果
SetDataHas (O.[[SetData]], next) 为true ，则- 执行 ?
IteratorClose (keysIter,NormalCompletion (unused ))。 - 返回
false 。
- 执行 ?
- 如果
- 将 next 设为 ?
- 令 keysIter 为 ?
- 返回
true 。
24.2.4.11 Set.prototype.isSubsetOf ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 如果
SetDataSize (O.[[SetData]]) > otherRec.[[Size]]，返回false 。 - 令 thisSize 为 O.[[SetData]] 的元素数量。
- 令 index 为 0。
- 重复，直到 index < thisSize，
- 返回
true 。
24.2.4.12 Set.prototype.isSupersetOf ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 如果
SetDataSize (O.[[SetData]]) < otherRec.[[Size]]，返回false 。 - 令 keysIter 为 ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]])。 - 令 next 为
not-started 。 - 重复，直到 next 不为
done ，- 将 next 设为 ?
IteratorStepValue (keysIter)。 - 如果 next 不为
done ，则- 如果
SetDataHas (O.[[SetData]], next) 为false ，则- 执行 ?
IteratorClose (keysIter,NormalCompletion (unused ))。 - 返回
false 。
- 执行 ?
- 如果
- 将 next 设为 ?
- 返回
true 。
24.2.4.13 Set.prototype.keys ( )
对于遍历目的，Set 类似于每个条目的键和值都相同的 Map。
24.2.4.14 get Set.prototype.size
Set.prototype.size 是一个
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[SetData]])。 - 令 size 为
SetDataSize (S.[[SetData]])。 - 返回
𝔽 (size)。
24.2.4.15 Set.prototype.symmetricDifference ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 令 keysIter 为 ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]])。 - 令 resultSetData 为 O.[[SetData]] 的一个副本。
- 令 next 为
not-started 。 - 重复，直到 next 不为
done ，- 将 next 设为 ?
IteratorStepValue (keysIter)。 - 如果 next 不为
done ，则- 将 next 设为
CanonicalizeKeyedCollectionKey (next)。 - 令 resultIndex 为
SetDataIndex (resultSetData, next)。 - 如果 resultIndex 为
not-found ，令 alreadyInResult 为false 。否则令 alreadyInResult 为true 。 - 如果
SetDataHas (O.[[SetData]], next) 为true ，则- 如果 alreadyInResult 为
true ，将 resultSetData[resultIndex] 设为empty 。
- 如果 alreadyInResult 为
- 否则，
- 如果 alreadyInResult 为
false ，将 next 添加到 resultSetData。
- 如果 alreadyInResult 为
- 将 next 设为
- 将 next 设为 ?
- 令 result 为
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)。 - 设置 result.[[SetData]] 为 resultSetData。
- 返回 result。
24.2.4.16 Set.prototype.union ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 令 keysIter 为 ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]])。 - 令 resultSetData 为 O.[[SetData]] 的一个副本。
- 令 next 为
not-started 。 - 重复，直到 next 不为
done ，- 将 next 设为 ?
IteratorStepValue (keysIter)。 - 如果 next 不为
done ，则- 将 next 设为
CanonicalizeKeyedCollectionKey (next)。 - 如果
SetDataHas (resultSetData, next) 为false ，则- 将 next 添加到 resultSetData。
- 将 next 设为
- 将 next 设为 ?
- 令 result 为
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)。 - 设置 result.[[SetData]] 为 resultSetData。
- 返回 result。
24.2.4.17 Set.prototype.values ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateSetIterator (S,value )。
24.2.4.18 Set.prototype [ %Symbol.iterator% ] ( )
24.2.4.19 Set.prototype [ %Symbol.toStringTag% ]
该属性具有属性 { [[Writable]]:
24.2.5 Set 实例的属性
Set 实例是
24.2.6 Set 迭代器对象
Set
迭代器 是一个
24.2.6.1 CreateSetIterator ( set, kind )
抽象操作 CreateSetIterator 接收参数 set（一个
- 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 令 closure 为一个新的
抽象闭包 ，无参数，捕获 set 和 kind，调用时执行以下步骤：- 令 index 为 0。
- 令 entries 为 set.[[SetData]]。
- 令 numEntries 为 entries 的元素数量。
- 重复，直到 index < numEntries，
- 令 e 为 entries[index]。
- 设置 index 为 index + 1。
- 如果 e 不为
empty ，则- 如果 kind 是
key+value ，则- 令 result 为
CreateArrayFromList (« e, e »)。 - 执行 ?
GeneratorYield (CreateIteratorResultObject (result,false ))。
- 令 result 为
- 否则，
断言 ：kind 是value 。- 执行 ?
GeneratorYield (CreateIteratorResultObject (e,false ))。
- 注：在
GeneratorYield 挂起本抽象操作执行期间，entries 的元素数量可能增加。 - 设置 numEntries 为 entries 的当前元素数量。
- 如果 kind 是
- 返回
undefined 。
- 返回
CreateIteratorFromClosure (closure,"%SetIteratorPrototype%" ,%SetIteratorPrototype% )。
24.2.6.2 %SetIteratorPrototype% 对象
%SetIteratorPrototype% 对象：
- 拥有所有
Set 迭代器对象 可继承的属性。 - 是一个
普通对象 。 - 拥有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 拥有以下属性：
24.2.6.2.1 %SetIteratorPrototype%.next ( )
- 返回 ?
GeneratorResume (this 值,empty ,"%SetIteratorPrototype%" )。
24.2.6.2.2 %SetIteratorPrototype% [ %Symbol.toStringTag% ]
该属性具有属性 { [[Writable]]:
24.3 WeakMap 对象
WeakMap 是键/值对的集合，其中键是对象和/或符号，值可以是任意的
实现可能会对 WeakMap 的某个键/值对变得不可访问与被移除之间施加任意的延迟。如果这个延迟对 ECMAScript 程序是可观察的，则会带来不确定性，影响程序执行。因此，ECMAScript 的实现不得提供任何无需观察者持有该键即可观察 WeakMap 键的手段。
WeakMap 必须通过哈希表或其他机制实现，这些机制在平均情况下能提供次线性的键/值对访问时间。本规范中所用的数据结构仅用于描述 WeakMap 所需的可观察语义，而非实际的实现模型。
WeakMap 和 WeakSet 旨在为对象或符号动态关联状态，且如果没有 WeakMap 或 WeakSet 实例，该对象或符号变得不可访问并被垃圾回收机制回收时，不会“泄漏”内存资源。可以通过将 WeakMap 或 WeakSet 实例反向映射到每个对象/符号实现这一特性。或者，每个 WeakMap 或 WeakSet 实例可以内部存储其键和值数据，但这种方法需要 WeakMap/WeakSet 实现与垃圾回收器协作。下列参考文献介绍了对 WeakMap 和 WeakSet 实现可能有用的机制：
Barry Hayes. 1997. Ephemerons: a new finalization mechanism. 载于 Proceedings of the 12th ACM SIGPLAN conference on Object-oriented programming, systems, languages, and applications (OOPSLA '97), A. Michael Berman (编辑). ACM, New York, NY, USA, 176-183, http://doi.acm.org/10.1145/263698.263733.
Alexandra Barros, Roberto Ierusalimschy, Eliminating Cycles in Weak Tables. Journal of Universal Computer Science - J.UCS, vol. 14, no. 21, pp. 3481-3497, 2008, http://www.jucs.org/jucs_14_21/eliminating_cycles_in_weak
24.3.1 WeakMap 构造函数
WeakMap
- 即 %WeakMap%。
- 是
全局对象 的"WeakMap" 属性的初始值。 - 作为
构造函数 调用时会创建并初始化一个新的 WeakMap。 - 不应作为普通函数调用，否则会抛出异常。
- 可以用作类定义的
extends子句的值。想要继承指定 WeakMap 行为的子类构造函数 必须包含对 WeakMap构造函数 的super调用，以用必要的内部状态创建和初始化子类实例，以支持WeakMap.prototype内建方法。
24.3.1.1 WeakMap ( [ iterable ] )
该函数被调用时执行以下步骤：
- 如果 NewTarget 为
undefined ，抛出TypeError 异常。 - 令 map 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakMap.prototype%" , « [[WeakMapData]] »)。 - 设置 map.[[WeakMapData]] 为一个新的空
List 。 - 如果 iterable 为
undefined 或null ，返回 map。 - 令 adder 为 ?
Get (map,"set" )。 - 如果
IsCallable (adder) 为false ，抛出TypeError 异常。 - 返回 ?
AddEntriesFromIterable (map, iterable, adder)。
如果参数 iterable 存在，期望它是一个实现了
24.3.2 WeakMap 构造函数的属性
WeakMap
- 拥有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 拥有以下属性：
24.3.2.1 WeakMap.prototype
WeakMap.prototype 的初始值为
该属性具有属性 { [[Writable]]:
24.3.3 WeakMap 原型对象的属性
WeakMap 原型对象：
- 即 %WeakMap.prototype%。
- 拥有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是一个
普通对象 。 - 没有 [[WeakMapData]] 内部槽。
24.3.3.1 WeakMap.prototype.constructor
WeakMap.prototype.constructor 的初始值为
24.3.3.2 WeakMap.prototype.delete ( key )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 为false ，返回false 。 - 对于 M.[[WeakMapData]] 中的每个
Record { [[Key]], [[Value]] } p，执行- 如果 p.[[Key]] 不为
empty 且SameValue (p.[[Key]], key) 为true ，则- 将 p.[[Key]] 设为
empty 。 - 将 p.[[Value]] 设为
empty 。 - 返回
true 。
- 将 p.[[Key]] 设为
- 如果 p.[[Key]] 不为
- 返回
false 。
24.3.3.3 WeakMap.prototype.get ( key )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 为false ，返回undefined 。 - 对于 M.[[WeakMapData]] 中的每个
Record { [[Key]], [[Value]] } p，执行- 如果 p.[[Key]] 不为
empty 且SameValue (p.[[Key]], key) 为true ，返回 p.[[Value]]。
- 如果 p.[[Key]] 不为
- 返回
undefined 。
24.3.3.4 WeakMap.prototype.has ( key )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 为false ，返回false 。 - 对于 M.[[WeakMapData]] 中的每个
Record { [[Key]], [[Value]] } p，执行- 如果 p.[[Key]] 不为
empty 且SameValue (p.[[Key]], key) 为true ，返回true 。
- 如果 p.[[Key]] 不为
- 返回
false 。
24.3.3.5 WeakMap.prototype.set ( key, value )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 为false ，抛出TypeError 异常。 - 对于 M.[[WeakMapData]] 中的每个
Record { [[Key]], [[Value]] } p，执行- 如果 p.[[Key]] 不为
empty 且SameValue (p.[[Key]], key) 为true ，则- 将 p.[[Value]] 设为 value。
- 返回 M。
- 如果 p.[[Key]] 不为
- 令 p 为
Record { [[Key]]: key, [[Value]]: value }。 - 将 p 添加到 M.[[WeakMapData]]。
- 返回 M。
24.3.3.6 WeakMap.prototype [ %Symbol.toStringTag% ]
该属性具有属性 { [[Writable]]:
24.3.4 WeakMap 实例的属性
WeakMap 实例是
24.4 WeakSet 对象
WeakSet 是对象和/或符号的集合。在 WeakSet 的集合中，每个不同的对象或符号只能出现一次。WeakSet
可以用来查询是否包含某个特定值，但没有机制用于枚举它所持有的所有值。在某些情况下，非
实现可能会对 WeakSet 所包含的某个值变得不可访问与被移除之间施加任意的延迟。如果这个延迟对 ECMAScript 程序是可观察的，则会带来不确定性，影响程序执行。因此，ECMAScript 的实现不得提供任何无需观察者持有该值即可确定 WeakSet 是否包含该值的手段。
WeakSet 必须通过哈希表或其他机制实现，这些机制在平均情况下能提供次线性的元素访问时间。本规范中所用的数据结构仅用于描述 WeakSet 所需的可观察语义，而非实际的实现模型。
参见
24.4.1 WeakSet 构造函数
WeakSet
- 即 %WeakSet%。
- 是
全局对象 的"WeakSet" 属性的初始值。 - 作为
构造函数 调用时会创建并初始化一个新的 WeakSet。 - 不应作为普通函数调用，否则会抛出异常。
- 可以用作类定义的
extends子句的值。想要继承指定 WeakSet 行为的子类构造函数 必须包含对 WeakSet构造函数 的super调用，以用必要的内部状态创建和初始化子类实例，以支持WeakSet.prototype内建方法。
24.4.1.1 WeakSet ( [ iterable ] )
该函数被调用时执行以下步骤：
- 如果 NewTarget 为
undefined ，抛出TypeError 异常。 - 令 set 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakSet.prototype%" , « [[WeakSetData]] »)。 - 设置 set.[[WeakSetData]] 为一个新的空
List 。 - 如果 iterable 为
undefined 或null ，返回 set。 - 令 adder 为 ?
Get (set,"add" )。 - 如果
IsCallable (adder) 为false ，抛出TypeError 异常。 - 令 iteratorRecord 为 ?
GetIterator (iterable,sync )。 - 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 为
done ，返回 set。 - 令 status 为
Completion (Call (adder, set, « next »))。 IfAbruptCloseIterator (status, iteratorRecord)。
- 令 next 为 ?
24.4.2 WeakSet 构造函数的属性
WeakSet
- 拥有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 拥有以下属性：
24.4.2.1 WeakSet.prototype
WeakSet.prototype 的初始值为
该属性具有属性 { [[Writable]]:
24.4.3 WeakSet 原型对象的属性
WeakSet 原型对象：
- 即 %WeakSet.prototype%。
- 拥有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是一个
普通对象 。 - 没有 [[WeakSetData]] 内部槽。
24.4.3.1 WeakSet.prototype.add ( value )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[WeakSetData]])。 - 如果
CanBeHeldWeakly (value) 为false ，抛出TypeError 异常。 - 对于 S.[[WeakSetData]] 的每个元素 e，执行
- 如果 e 不为
empty 且SameValue (e, value) 为true ，则- 返回 S。
- 如果 e 不为
- 将 value 添加到 S.[[WeakSetData]]。
- 返回 S。
24.4.3.2 WeakSet.prototype.constructor
WeakSet.prototype.constructor 的初始值为
24.4.3.3 WeakSet.prototype.delete ( value )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[WeakSetData]])。 - 如果
CanBeHeldWeakly (value) 为false ，返回false 。 - 对于 S.[[WeakSetData]] 的每个元素 e，执行
- 如果 e 不为
empty 且SameValue (e, value) 为true ，则- 将 S.[[WeakSetData]] 中值为
e 的元素替换为值为
empty 的元素。 - 返回
true 。
- 将 S.[[WeakSetData]] 中值为
e 的元素替换为值为
- 如果 e 不为
- 返回
false 。
24.4.3.4 WeakSet.prototype.has ( value )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[WeakSetData]])。 - 如果
CanBeHeldWeakly (value) 为false ，返回false 。 - 对于 S.[[WeakSetData]] 的每个元素 e，执行
- 如果 e 不为
empty 且SameValue (e, value) 为true ，返回true 。
- 如果 e 不为
- 返回
false 。
24.4.3.5 WeakSet.prototype [ %Symbol.toStringTag% ]
该属性具有属性 { [[Writable]]:
24.4.4 WeakSet 实例的属性
WeakSet 实例是
24.5 键控集合的抽象操作
24.5.1 CanonicalizeKeyedCollectionKey ( key )
抽象操作 CanonicalizeKeyedCollectionKey 接收参数 key（一个
- 如果 key 是
-0 𝔽，返回+0 𝔽。 - 返回 key。
25 Structured Data
25.1 ArrayBuffer Objects
25.1.1 Notation
The descriptions below in this section,
A read-modify-write
modification function is a mathematical function that is represented as an abstract
closure that takes two
- They perform all their algorithm steps atomically.
- Their individual algorithm steps are not observable.
To aid verifying that a read-modify-write modification function's algorithm steps constitute a pure, mathematical function, the following editorial conventions are recommended:
- They do not access, directly or transitively via invoked
abstract operations and abstract closures, any language or specification values except their parameters and captured values. - They do not invoke, directly or transitively,
abstract operations and abstract closures that returnCompletion Records . - They do not return
Completion Records .
25.1.2 Fixed-length and Resizable ArrayBuffer Objects
A fixed-length ArrayBuffer is an ArrayBuffer whose byte length cannot change after creation.
A resizable ArrayBuffer is an ArrayBuffer whose byte length may change
after creation via calls to
The kind of ArrayBuffer object that is created depends on the arguments passed to
25.1.3 Abstract Operations For ArrayBuffer Objects
25.1.3.1 AllocateArrayBuffer ( constructor, byteLength [ , maxByteLength ] )
The abstract operation AllocateArrayBuffer takes arguments constructor (a
- Let slots be « [[ArrayBufferData]], [[ArrayBufferByteLength]], [[ArrayBufferDetachKey]] ».
- If maxByteLength is present and maxByteLength is not
empty , let allocatingResizableBuffer betrue ; otherwise let allocatingResizableBuffer befalse . - If allocatingResizableBuffer is
true , then- If byteLength > maxByteLength, throw a
RangeError exception. - Append [[ArrayBufferMaxByteLength]] to slots.
- If byteLength > maxByteLength, throw a
- Let obj be ?
OrdinaryCreateFromConstructor (constructor,"%ArrayBuffer.prototype%" , slots). - Let block be ?
CreateByteDataBlock (byteLength). - Set obj.[[ArrayBufferData]] to block.
- Set obj.[[ArrayBufferByteLength]] to byteLength.
- If allocatingResizableBuffer is
true , then- If it is not possible to create a
Data Block block consisting of maxByteLength bytes, throw aRangeError exception. - NOTE: Resizable ArrayBuffers are designed to be implementable with in-place growth. Implementations may throw if, for example, virtual memory cannot be reserved up front.
- Set obj.[[ArrayBufferMaxByteLength]] to maxByteLength.
- If it is not possible to create a
- Return obj.
25.1.3.2 ArrayBufferByteLength ( arrayBuffer, order )
The abstract operation ArrayBufferByteLength takes arguments arrayBuffer (an
ArrayBuffer or SharedArrayBuffer) and order (
- If
IsSharedArrayBuffer (arrayBuffer) istrue and arrayBuffer has an [[ArrayBufferByteLengthData]] internal slot, then- Let bufferByteLengthBlock be arrayBuffer.[[ArrayBufferByteLengthData]].
- Let rawLength be
GetRawBytesFromSharedBlock (bufferByteLengthBlock, 0,biguint64 ,true , order). - Let isLittleEndian be the value of the [[LittleEndian]] field of the
surrounding agent 'sAgent Record . - Return
ℝ (RawBytesToNumeric (biguint64 , rawLength, isLittleEndian)).
Assert :IsDetachedBuffer (arrayBuffer) isfalse .- Return arrayBuffer.[[ArrayBufferByteLength]].
25.1.3.3 ArrayBufferCopyAndDetach ( arrayBuffer, newLength, preserveResizability )
The abstract operation ArrayBufferCopyAndDetach takes arguments arrayBuffer (an
- Perform ?
RequireInternalSlot (arrayBuffer, [[ArrayBufferData]]). - If
IsSharedArrayBuffer (arrayBuffer) istrue , throw aTypeError exception. - If newLength is
undefined , then- Let newByteLength be arrayBuffer.[[ArrayBufferByteLength]].
- Else,
- Let newByteLength be ?
ToIndex (newLength).
- Let newByteLength be ?
- If
IsDetachedBuffer (arrayBuffer) istrue , throw aTypeError exception. - If preserveResizability is
preserve-resizability andIsFixedLengthArrayBuffer (arrayBuffer) isfalse , then- Let newMaxByteLength be arrayBuffer.[[ArrayBufferMaxByteLength]].
- Else,
- Let newMaxByteLength be
empty .
- Let newMaxByteLength be
- If arrayBuffer.[[ArrayBufferDetachKey]] is not
undefined , throw aTypeError exception. - Let newBuffer be ?
AllocateArrayBuffer (%ArrayBuffer% , newByteLength, newMaxByteLength). - Let copyLength be
min (newByteLength, arrayBuffer.[[ArrayBufferByteLength]]). - Let fromBlock be arrayBuffer.[[ArrayBufferData]].
- Let toBlock be newBuffer.[[ArrayBufferData]].
- Perform
CopyDataBlockBytes (toBlock, 0, fromBlock, 0, copyLength). - NOTE: Neither creation of the new
Data Block nor copying from the oldData Block are observable. Implementations may implement this method as a zero-copy move or arealloc. - Perform !
DetachArrayBuffer (arrayBuffer). - Return newBuffer.
25.1.3.4 IsDetachedBuffer ( arrayBuffer )
The abstract operation IsDetachedBuffer takes argument arrayBuffer (an ArrayBuffer or a SharedArrayBuffer) and returns a Boolean. It performs the following steps when called:
- If arrayBuffer.[[ArrayBufferData]] is
null , returntrue . - Return
false .
25.1.3.5 DetachArrayBuffer ( arrayBuffer [ , key ] )
The abstract operation DetachArrayBuffer takes argument arrayBuffer (an
ArrayBuffer) and optional argument key (anything) and returns either a
Assert :IsSharedArrayBuffer (arrayBuffer) isfalse .- If key is not present, set key to
undefined . - If arrayBuffer.[[ArrayBufferDetachKey]] is not
key, throw a
TypeError exception. - Set arrayBuffer.[[ArrayBufferData]] to
null . - Set arrayBuffer.[[ArrayBufferByteLength]] to 0.
- Return
unused .
Detaching an ArrayBuffer instance disassociates the
25.1.3.6 CloneArrayBuffer ( srcBuffer, srcByteOffset, srcLength )
The abstract operation CloneArrayBuffer takes arguments srcBuffer (an ArrayBuffer
or a SharedArrayBuffer), srcByteOffset (a non-negative
Assert :IsDetachedBuffer (srcBuffer) isfalse .- Let targetBuffer be ?
AllocateArrayBuffer (%ArrayBuffer% , srcLength). - Let srcBlock be srcBuffer.[[ArrayBufferData]].
- Let targetBlock be targetBuffer.[[ArrayBufferData]].
- Perform
CopyDataBlockBytes (targetBlock, 0, srcBlock, srcByteOffset, srcLength). - Return targetBuffer.
25.1.3.7 GetArrayBufferMaxByteLengthOption ( options )
The abstract operation GetArrayBufferMaxByteLengthOption takes argument options
(an
- If options
is not an Object , returnempty . - Let maxByteLength be ?
Get (options,"maxByteLength" ). - If maxByteLength is
undefined , returnempty . - Return ?
ToIndex (maxByteLength).
25.1.3.8 HostResizeArrayBuffer ( buffer, newByteLength )
The
The implementation of HostResizeArrayBuffer must conform to the following requirements:
- The abstract operation does not detach buffer.
- If the abstract operation completes normally with
handled , buffer.[[ArrayBufferByteLength]] is newByteLength.
The default implementation of HostResizeArrayBuffer is to return
25.1.3.9 IsFixedLengthArrayBuffer ( arrayBuffer )
The abstract operation IsFixedLengthArrayBuffer takes argument arrayBuffer (an ArrayBuffer or a SharedArrayBuffer) and returns a Boolean. It performs the following steps when called:
- If arrayBuffer has an [[ArrayBufferMaxByteLength]] internal slot, return
false . - Return
true .
25.1.3.10 IsUnsignedElementType ( type )
The abstract operation IsUnsignedElementType takes argument type (a
- If type is one of
uint8 ,uint8clamped ,uint16 ,uint32 , orbiguint64 , returntrue . - Return
false .
25.1.3.11 IsUnclampedIntegerElementType ( type )
The abstract operation IsUnclampedIntegerElementType takes argument type (a
- If type is one of
int8 ,uint8 ,int16 ,uint16 ,int32 , oruint32 , returntrue . - Return
false .
25.1.3.12 IsBigIntElementType ( type )
The abstract operation IsBigIntElementType takes argument type (a
- If type is either
biguint64 orbigint64 , returntrue . - Return
false .
25.1.3.13 IsNoTearConfiguration ( type, order )
The abstract operation IsNoTearConfiguration takes arguments type (a
- If
IsUnclampedIntegerElementType (type) istrue , returntrue . - If
IsBigIntElementType (type) istrue and order is neitherinit norunordered , returntrue . - Return
false .
25.1.3.14 RawBytesToNumeric ( type, rawBytes, isLittleEndian )
The abstract operation RawBytesToNumeric takes arguments type (a
- Let elementSize be the Element Size value specified in
Table 75 for Element Type type. - If isLittleEndian is
false , reverse the order of the elements of rawBytes. - If type is
float16 , then- Let value be the byte elements of rawBytes
concatenated and interpreted as a little-endian bit string encoding of an
IEEE 754-2019 binary16 value. - If value is a NaN, return
NaN . - Return the Number value that corresponds to value.
- Let value be the byte elements of rawBytes
concatenated and interpreted as a little-endian bit string encoding of an
- If type is
float32 , then- Let value be the byte elements of rawBytes
concatenated and interpreted as a little-endian bit string encoding of an
IEEE 754-2019 binary32 value. - If value is a NaN, return
NaN . - Return the Number value that corresponds to value.
- Let value be the byte elements of rawBytes
concatenated and interpreted as a little-endian bit string encoding of an
- If type is
float64 , then- Let value be the byte elements of rawBytes
concatenated and interpreted as a little-endian bit string encoding of an
IEEE 754-2019 binary64 value. - If value is a NaN, return
NaN . - Return the Number value that corresponds to value.
- Let value be the byte elements of rawBytes
concatenated and interpreted as a little-endian bit string encoding of an
- If
IsUnsignedElementType (type) istrue , then- Let intValue be the byte elements of rawBytes concatenated and interpreted as a bit string encoding of an unsigned little-endian binary number.
- Else,
- Let intValue be the byte elements of rawBytes concatenated and interpreted as a bit string encoding of a binary little-endian two's complement number of bit length elementSize × 8.
- If
IsBigIntElementType (type) istrue , return the BigInt value that corresponds to intValue. - Otherwise, return the Number value that corresponds to intValue.
25.1.3.15 GetRawBytesFromSharedBlock ( block, byteIndex, type, isTypedArray, order )
The abstract operation GetRawBytesFromSharedBlock takes arguments block (a
- Let elementSize be the Element Size value specified in
Table 75 for Element Type type. - Let execution be the [[CandidateExecution]]
field of the
surrounding agent 'sAgent Record . - Let eventsRecord be the
Agent Events Record of execution.[[EventsRecords]] whose [[AgentSignifier]] isAgentSignifier (). - If isTypedArray is
true andIsNoTearConfiguration (type, order) istrue , let noTear betrue ; otherwise let noTear befalse . - Let rawValue be a
List of length elementSize whose elements are nondeterministically chosenbyte values . - NOTE: In implementations, rawValue is the result of a non-atomic or
atomic read instruction on the underlying hardware. The nondeterminism is a semantic
prescription of the
memory model to describe observable behaviour of hardware with weak consistency. - Let readEvent be
ReadSharedMemory { [[Order]]: order, [[NoTear]]: noTear, [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize }. - Append readEvent to eventsRecord.[[EventList]].
- Append
Chosen Value Record { [[Event]]: readEvent, [[ChosenValue]]: rawValue } to execution.[[ChosenValues]]. - Return rawValue.
25.1.3.16 GetValueFromBuffer ( arrayBuffer, byteIndex, type, isTypedArray, order [ , isLittleEndian ] )
The abstract operation GetValueFromBuffer takes arguments arrayBuffer (an
ArrayBuffer or SharedArrayBuffer), byteIndex (a non-negative
Assert :IsDetachedBuffer (arrayBuffer) isfalse .Assert : There are sufficient bytes in arrayBuffer starting at byteIndex to represent a value of type.- Let block be arrayBuffer.[[ArrayBufferData]].
- Let elementSize be the Element Size value specified in
Table 75 for Element Type type. - If
IsSharedArrayBuffer (arrayBuffer) istrue , thenAssert : block is aShared Data Block .- Let rawValue be
GetRawBytesFromSharedBlock (block, byteIndex, type, isTypedArray, order).
- Else,
Assert : The number of elements in rawValue is elementSize.- If isLittleEndian is not present, set isLittleEndian to the
value of the [[LittleEndian]] field of the
surrounding agent 'sAgent Record . - Return
RawBytesToNumeric (type, rawValue, isLittleEndian).
25.1.3.17 NumericToRawBytes ( type, value, isLittleEndian )
The abstract operation NumericToRawBytes takes arguments type (a
- If type is
float16 , then- Let rawBytes be a
List whose elements are the 2 bytes that are the result of converting value toIEEE 754-2019 binary16 format using roundTiesToEven mode. The bytes are arranged in little endian order. If value isNaN , rawBytes may be set to any implementation chosenIEEE 754-2019 binary16 format NaN encoding. An implementation must always choose the same encoding for each implementation distinguishableNaN value.
- Let rawBytes be a
- Else if type is
float32 , then- Let rawBytes be a
List whose elements are the 4 bytes that are the result of converting value toIEEE 754-2019 binary32 format using roundTiesToEven mode. The bytes are arranged in little endian order. If value isNaN , rawBytes may be set to any implementation chosenIEEE 754-2019 binary32 format NaN encoding. An implementation must always choose the same encoding for each implementation distinguishableNaN value.
- Let rawBytes be a
- Else if type is
float64 , then- Let rawBytes be a
List whose elements are the 8 bytes that are theIEEE 754-2019 binary64 format encoding of value. The bytes are arranged in little endian order. If value isNaN , rawBytes may be set to any implementation chosenIEEE 754-2019 binary64 format NaN encoding. An implementation must always choose the same encoding for each implementation distinguishableNaN value.
- Let rawBytes be a
- Else,
- Let n be the Element Size value specified in
Table 75 for Element Type type. - Let conversionOperation be the abstract operation named in the
Conversion Operation column in
Table 75 for Element Type type. - Let intValue be
ℝ (conversionOperation(value)). - If intValue ≥ 0, then
- Let rawBytes be a
List whose elements are the n-byte binary encoding of intValue. The bytes are ordered in little endian order.
- Let rawBytes be a
- Else,
- Let rawBytes be a
List whose elements are the n-byte binary two's complement encoding of intValue. The bytes are ordered in little endian order.
- Let rawBytes be a
- Let n be the Element Size value specified in
- If isLittleEndian is
false , reverse the order of the elements of rawBytes. - Return rawBytes.
25.1.3.18 SetValueInBuffer ( arrayBuffer, byteIndex, type, value, isTypedArray, order [ , isLittleEndian ] )
The abstract operation SetValueInBuffer takes arguments arrayBuffer (an
ArrayBuffer or SharedArrayBuffer), byteIndex (a non-negative
Assert :IsDetachedBuffer (arrayBuffer) isfalse .Assert : There are sufficient bytes in arrayBuffer starting at byteIndex to represent a value of type.Assert : valueis a BigInt ifIsBigIntElementType (type) istrue ; otherwise, valueis a Number .- Let block be arrayBuffer.[[ArrayBufferData]].
- Let elementSize be the Element Size value specified in
Table 75 for Element Type type. - If isLittleEndian is not present, set isLittleEndian to the
value of the [[LittleEndian]] field of the
surrounding agent 'sAgent Record . - Let rawBytes be
NumericToRawBytes (type, value, isLittleEndian). - If
IsSharedArrayBuffer (arrayBuffer) istrue , then- Let execution be the [[CandidateExecution]] field of the
surrounding agent 'sAgent Record . - Let eventsRecord be the
Agent Events Record of execution.[[EventsRecords]] whose [[AgentSignifier]] isAgentSignifier (). - If isTypedArray is
true andIsNoTearConfiguration (type, order) istrue , let noTear betrue ; otherwise let noTear befalse . - Append
WriteSharedMemory { [[Order]]: order, [[NoTear]]: noTear, [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize, [[Payload]]: rawBytes } to eventsRecord.[[EventList]].
- Let execution be the [[CandidateExecution]] field of the
- Else,
- Store the individual bytes of rawBytes into block, starting at block[byteIndex].
- Return
unused .
25.1.3.19 GetModifySetValueInBuffer ( arrayBuffer, byteIndex, type, value, op )
The abstract operation GetModifySetValueInBuffer takes arguments arrayBuffer (an
ArrayBuffer or a SharedArrayBuffer), byteIndex (a non-negative
Assert :IsDetachedBuffer (arrayBuffer) isfalse .Assert : There are sufficient bytes in arrayBuffer starting at byteIndex to represent a value of type.Assert : valueis a BigInt ifIsBigIntElementType (type) istrue ; otherwise, valueis a Number .- Let block be arrayBuffer.[[ArrayBufferData]].
- Let elementSize be the Element Size value specified in
Table 75 for Element Type type. - Let isLittleEndian be the value of the [[LittleEndian]] field of the
surrounding agent 'sAgent Record . - Let rawBytes be
NumericToRawBytes (type, value, isLittleEndian). - If
IsSharedArrayBuffer (arrayBuffer) istrue , then- Let execution be the [[CandidateExecution]] field of the
surrounding agent 'sAgent Record . - Let eventsRecord be the
Agent Events Record of execution.[[EventsRecords]] whose [[AgentSignifier]] isAgentSignifier (). - Let rawBytesRead be a
List of length elementSize whose elements are nondeterministically chosenbyte values . - NOTE: In implementations, rawBytesRead is the result of a
load-link, of a load-exclusive, or of an operand of a read-modify-write
instruction on the underlying hardware. The nondeterminism is a semantic
prescription of the
memory model to describe observable behaviour of hardware with weak consistency. - Let rmwEvent be
ReadModifyWriteSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize, [[Payload]]: rawBytes, [[ModifyOp]]: op }. - Append rmwEvent to eventsRecord.[[EventList]].
- Append
Chosen Value Record { [[Event]]: rmwEvent, [[ChosenValue]]: rawBytesRead } to execution.[[ChosenValues]].
- Let execution be the [[CandidateExecution]] field of the
- Else,
- Let rawBytesRead be a
List of length elementSize whose elements are the sequence of elementSize bytes starting with block[byteIndex]. - Let rawBytesModified be op(rawBytesRead, rawBytes).
- Store the individual bytes of rawBytesModified into block, starting at block[byteIndex].
- Let rawBytesRead be a
- Return
RawBytesToNumeric (type, rawBytesRead, isLittleEndian).
25.1.4 The ArrayBuffer Constructor
The ArrayBuffer
- is %ArrayBuffer%.
- is the initial value of the
"ArrayBuffer" property of theglobal object . - creates and initializes a new ArrayBuffer when called as a
constructor . - is not intended to be called as a function and will throw an exception when called in that manner.
- may be used as the value of an
extendsclause of a class definition. Subclassconstructors that intend to inherit the specified ArrayBuffer behaviour must include asupercall to the ArrayBufferconstructor to create and initialize subclass instances with the internal state necessary to support theArrayBuffer.prototypebuilt-in methods.
25.1.4.1 ArrayBuffer ( length [ , options ] )
This function performs the following steps when called:
- If NewTarget is
undefined , throw aTypeError exception. - Let byteLength be ?
ToIndex (length). - Let requestedMaxByteLength be ?
GetArrayBufferMaxByteLengthOption (options). - Return ?
AllocateArrayBuffer (NewTarget, byteLength, requestedMaxByteLength).
25.1.5 Properties of the ArrayBuffer Constructor
The ArrayBuffer
- has a [[Prototype]] internal slot whose value is
%Function.prototype% . - has the following properties:
25.1.5.1 ArrayBuffer.isView ( arg )
This function performs the following steps when called:
- If arg
is not an Object , returnfalse . - If arg has a [[ViewedArrayBuffer]] internal
slot, return
true . - Return
false .
25.1.5.2 ArrayBuffer.prototype
The initial value of ArrayBuffer.prototype is the
This property has the attributes { [[Writable]]:
25.1.5.3 get ArrayBuffer [ %Symbol.species% ]
ArrayBuffer[%Symbol.species%] is an
- Return the
this value.
The value of the
25.1.6 Properties of the ArrayBuffer Prototype Object
The ArrayBuffer prototype object:
- is %ArrayBuffer.prototype%.
- has a [[Prototype]] internal slot whose value is
%Object.prototype% . - is an
ordinary object . - does not have an [[ArrayBufferData]] or [[ArrayBufferByteLength]] internal slot.
25.1.6.1 get ArrayBuffer.prototype.byteLength
ArrayBuffer.prototype.byteLength is an
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[ArrayBufferData]]). - If
IsSharedArrayBuffer (O) istrue , throw aTypeError exception. - If
IsDetachedBuffer (O) istrue , return+0 𝔽. - Let length be O.[[ArrayBufferByteLength]].
- Return
𝔽 (length).
25.1.6.2 ArrayBuffer.prototype.constructor
The initial value of ArrayBuffer.prototype.constructor is
25.1.6.3 get ArrayBuffer.prototype.detached
ArrayBuffer.prototype.detached is an
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[ArrayBufferData]]). - If
IsSharedArrayBuffer (O) istrue , throw aTypeError exception. - Return
IsDetachedBuffer (O).
25.1.6.4 get ArrayBuffer.prototype.maxByteLength
ArrayBuffer.prototype.maxByteLength is an
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[ArrayBufferData]]). - If
IsSharedArrayBuffer (O) istrue , throw aTypeError exception. - If
IsDetachedBuffer (O) istrue , return+0 𝔽. - If
IsFixedLengthArrayBuffer (O) istrue , then- Let length be O.[[ArrayBufferByteLength]].
- Else,
- Let length be O.[[ArrayBufferMaxByteLength]].
- Return
𝔽 (length).
25.1.6.5 get ArrayBuffer.prototype.resizable
ArrayBuffer.prototype.resizable is an
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[ArrayBufferData]]). - If
IsSharedArrayBuffer (O) istrue , throw aTypeError exception. - If
IsFixedLengthArrayBuffer (O) isfalse , returntrue ; otherwise returnfalse .
25.1.6.6 ArrayBuffer.prototype.resize ( newLength )
This method performs the following steps when called:
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[ArrayBufferMaxByteLength]]). - If
IsSharedArrayBuffer (O) istrue , throw aTypeError exception. - Let newByteLength be ?
ToIndex (newLength). - If
IsDetachedBuffer (O) istrue , throw aTypeError exception. - If newByteLength > O.[[ArrayBufferMaxByteLength]], throw a
RangeError exception. - Let hostHandled be ?
HostResizeArrayBuffer (O, newByteLength). - If hostHandled is
handled , returnundefined . - Let oldBlock be O.[[ArrayBufferData]].
- Let newBlock be ?
CreateByteDataBlock (newByteLength). - Let copyLength be
min (newByteLength, O.[[ArrayBufferByteLength]]). - Perform
CopyDataBlockBytes (newBlock, 0, oldBlock, 0, copyLength). - NOTE: Neither creation of the new
Data Block nor copying from the oldData Block are observable. Implementations may implement this method as in-place growth or shrinkage. - Set O.[[ArrayBufferData]] to newBlock.
- Set O.[[ArrayBufferByteLength]] to newByteLength.
- Return
undefined .
25.1.6.7 ArrayBuffer.prototype.slice ( start, end )
This method performs the following steps when called:
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[ArrayBufferData]]). - If
IsSharedArrayBuffer (O) istrue , throw aTypeError exception. - If
IsDetachedBuffer (O) istrue , throw aTypeError exception. - Let len be O.[[ArrayBufferByteLength]].
- Let relativeStart be ?
ToIntegerOrInfinity (start). - If relativeStart = -∞, let first be 0.
- Else if relativeStart < 0, let first be
max (len + relativeStart, 0). - Else, let first be
min (relativeStart, len). - If end is
undefined , let relativeEnd be len; else let relativeEnd be ?ToIntegerOrInfinity (end). - If relativeEnd = -∞, let final be 0.
- Else if relativeEnd < 0, let final be
max (len + relativeEnd, 0). - Else, let final be
min (relativeEnd, len). - Let newLen be
max (final - first, 0). - Let ctor be ?
SpeciesConstructor (O,%ArrayBuffer% ). - Let new be ?
Construct (ctor, «𝔽 (newLen) »). - Perform ?
RequireInternalSlot (new, [[ArrayBufferData]]). - If
IsSharedArrayBuffer (new) istrue , throw aTypeError exception. - If
IsDetachedBuffer (new) istrue , throw aTypeError exception. - If
SameValue (new, O) istrue , throw aTypeError exception. - If new.[[ArrayBufferByteLength]] <
newLen, throw a
TypeError exception. - NOTE: Side-effects of the above steps may have detached or resized O.
- If
IsDetachedBuffer (O) istrue , throw aTypeError exception. - Let fromBuf be O.[[ArrayBufferData]].
- Let toBuf be new.[[ArrayBufferData]].
- Let currentLen be O.[[ArrayBufferByteLength]].
- If first < currentLen, then
- Let count be
min (newLen, currentLen - first). - Perform
CopyDataBlockBytes (toBuf, 0, fromBuf, first, count).
- Let count be
- Return new.
25.1.6.8 ArrayBuffer.prototype.transfer ( [ newLength ] )
This method performs the following steps when called:
- Let O be the
this value. - Return ?
ArrayBufferCopyAndDetach (O, newLength,preserve-resizability ).
25.1.6.9 ArrayBuffer.prototype.transferToFixedLength ( [ newLength ] )
This method performs the following steps when called:
- Let O be the
this value. - Return ?
ArrayBufferCopyAndDetach (O, newLength,fixed-length ).
25.1.6.10 ArrayBuffer.prototype [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
25.1.7 Properties of ArrayBuffer Instances
ArrayBuffer instances inherit properties from the
ArrayBuffer instances whose [[ArrayBufferData]] is
ArrayBuffer instances whose [[ArrayBufferDetachKey]] is set to a value
other than
25.1.8 Resizable ArrayBuffer Guidelines
The following are guidelines for ECMAScript programmers working with
We recommend that programs be tested in their deployment environments where possible. The amount of available physical memory differs greatly between hardware devices. Similarly, virtual memory subsystems also differ greatly between hardware devices as well as operating systems. An application that runs without out-of-memory errors on a 64-bit desktop web browser could run out of memory on a 32-bit mobile web browser.
When choosing a value for the
Please note that successfully constructing a
The following are guidelines for ECMAScript implementers implementing
If a
If a
25.2 SharedArrayBuffer Objects
25.2.1 Fixed-length and Growable SharedArrayBuffer Objects
A fixed-length SharedArrayBuffer is a SharedArrayBuffer whose byte length cannot change after creation.
A growable SharedArrayBuffer is a SharedArrayBuffer whose byte length
may increase after creation via calls to
The kind of SharedArrayBuffer object that is created depends on the arguments passed to
25.2.2 Abstract Operations for SharedArrayBuffer Objects
25.2.2.1 AllocateSharedArrayBuffer ( constructor, byteLength [ , maxByteLength ] )
The abstract operation AllocateSharedArrayBuffer takes arguments constructor (a
- Let slots be « [[ArrayBufferData]] ».
- If maxByteLength is present and maxByteLength is not
empty , let allocatingGrowableBuffer betrue ; otherwise let allocatingGrowableBuffer befalse . - If allocatingGrowableBuffer is
true , then- If byteLength > maxByteLength, throw a
RangeError exception. - Append [[ArrayBufferByteLengthData]] and [[ArrayBufferMaxByteLength]] to slots.
- If byteLength > maxByteLength, throw a
- Else,
- Append [[ArrayBufferByteLength]] to slots.
- Let obj be ?
OrdinaryCreateFromConstructor (constructor,"%SharedArrayBuffer.prototype%" , slots). - If allocatingGrowableBuffer is
true , let allocLength be maxByteLength; otherwise let allocLength be byteLength. - Let block be ?
CreateSharedByteDataBlock (allocLength). - Set obj.[[ArrayBufferData]] to block.
- If allocatingGrowableBuffer is
true , thenAssert : byteLength ≤ maxByteLength.- Let byteLengthBlock be ?
CreateSharedByteDataBlock (8). - Perform
SetValueInBuffer (byteLengthBlock, 0,biguint64 ,ℤ (byteLength),true ,seq-cst ). - Set obj.[[ArrayBufferByteLengthData]] to byteLengthBlock.
- Set obj.[[ArrayBufferMaxByteLength]] to maxByteLength.
- Else,
- Set obj.[[ArrayBufferByteLength]] to byteLength.
- Return obj.
25.2.2.2 IsSharedArrayBuffer ( obj )
The abstract operation IsSharedArrayBuffer takes argument obj (an ArrayBuffer or a SharedArrayBuffer) and returns a Boolean. It tests whether an object is an ArrayBuffer, a SharedArrayBuffer, or a subtype of either. It performs the following steps when called:
- Let bufferData be obj.[[ArrayBufferData]].
- If bufferData is
null , returnfalse . - If bufferData is a
Data Block , returnfalse . Assert : bufferData is aShared Data Block .- Return
true .
25.2.2.3 HostGrowSharedArrayBuffer ( buffer, newByteLength )
The
The implementation of HostGrowSharedArrayBuffer must conform to the following requirements:
- If the abstract operation does not complete normally with
unhandled , and newByteLength < the current byte length of the buffer or newByteLength > buffer.[[ArrayBufferMaxByteLength]], throw aRangeError exception. - Let isLittleEndian be the value of the [[LittleEndian]] field of the
surrounding agent 'sAgent Record . If the abstract operation completes normally withhandled , aWriteSharedMemory orReadModifyWriteSharedMemory event whose [[Order]] isseq-cst , [[Payload]] isNumericToRawBytes (biguint64 , newByteLength, isLittleEndian), [[Block]] is buffer.[[ArrayBufferByteLengthData]], [[ByteIndex]] is 0, and [[ElementSize]] is 8 is added to thesurrounding agent 'scandidate execution such that racing calls toSharedArrayBuffer.prototype.groware not "lost", i.e. silently do nothing.
The second requirement above is intentionally vague about how or when the current byte length of buffer is read. Because the byte length must be updated via an atomic read-modify-write operation on the underlying hardware, architectures that use load-link/store-conditional or load-exclusive/store-exclusive instruction pairs may wish to keep the paired instructions close in the instruction stream. As such, SharedArrayBuffer.prototype.grow itself does not perform bounds checking on newByteLength before calling HostGrowSharedArrayBuffer, nor is there a requirement on when the current byte length is read.
This is in contrast with
The default implementation of HostGrowSharedArrayBuffer is to return
25.2.3 The SharedArrayBuffer Constructor
The SharedArrayBuffer
- is %SharedArrayBuffer%.
- is the initial value of the
"SharedArrayBuffer" property of theglobal object , if that property is present (see below). - creates and initializes a new SharedArrayBuffer when called as a
constructor . - is not intended to be called as a function and will throw an exception when called in that manner.
- may be used as the value of an
extendsclause of a class definition. Subclassconstructors that intend to inherit the specified SharedArrayBuffer behaviour must include asupercall to the SharedArrayBufferconstructor to create and initialize subclass instances with the internal state necessary to support theSharedArrayBuffer.prototypebuilt-in methods.
Whenever a
Unlike an ArrayBuffer, a SharedArrayBuffer cannot become
detached, and its internal [[ArrayBufferData]] slot is never
25.2.3.1 SharedArrayBuffer ( length [ , options ] )
This function performs the following steps when called:
- If NewTarget is
undefined , throw aTypeError exception. - Let byteLength be ?
ToIndex (length). - Let requestedMaxByteLength be ?
GetArrayBufferMaxByteLengthOption (options). - Return ?
AllocateSharedArrayBuffer (NewTarget, byteLength, requestedMaxByteLength).
25.2.4 Properties of the SharedArrayBuffer Constructor
The SharedArrayBuffer
- has a [[Prototype]] internal slot whose value is
%Function.prototype% . - has the following properties:
25.2.4.1 SharedArrayBuffer.prototype
The initial value of SharedArrayBuffer.prototype is the
This property has the attributes { [[Writable]]:
25.2.4.2 get SharedArrayBuffer [ %Symbol.species% ]
SharedArrayBuffer[%Symbol.species%] is an
- Return the
this value.
The value of the
25.2.5 Properties of the SharedArrayBuffer Prototype Object
The SharedArrayBuffer prototype object:
- is %SharedArrayBuffer.prototype%.
- has a [[Prototype]] internal slot whose value is
%Object.prototype% . - is an
ordinary object . - does not have an [[ArrayBufferData]] or [[ArrayBufferByteLength]] internal slot.
25.2.5.1 get SharedArrayBuffer.prototype.byteLength
SharedArrayBuffer.prototype.byteLength is an
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[ArrayBufferData]]). - If
IsSharedArrayBuffer (O) isfalse , throw aTypeError exception. - Let length be
ArrayBufferByteLength (O,seq-cst ). - Return
𝔽 (length).
25.2.5.2 SharedArrayBuffer.prototype.constructor
The initial value of SharedArrayBuffer.prototype.constructor is
25.2.5.3 SharedArrayBuffer.prototype.grow ( newLength )
This method performs the following steps when called:
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[ArrayBufferMaxByteLength]]). - If
IsSharedArrayBuffer (O) isfalse , throw aTypeError exception. - Let newByteLength be ?
ToIndex (newLength). - Let hostHandled be ?
HostGrowSharedArrayBuffer (O, newByteLength). - If hostHandled is
handled , returnundefined . - Let isLittleEndian be the value of the [[LittleEndian]] field of the
surrounding agent 'sAgent Record . - Let byteLengthBlock be O.[[ArrayBufferByteLengthData]].
- Let currentByteLengthRawBytes be
GetRawBytesFromSharedBlock (byteLengthBlock, 0,biguint64 ,true ,seq-cst ). - Let newByteLengthRawBytes be
NumericToRawBytes (biguint64 ,ℤ (newByteLength), isLittleEndian). - Repeat,
- NOTE: This is a compare-and-exchange loop to ensure that parallel, racing grows of the same buffer are totally ordered, are not lost, and do not silently do nothing. The loop exits if it was able to attempt to grow uncontended.
- Let currentByteLength be
ℝ (RawBytesToNumeric (biguint64 , currentByteLengthRawBytes, isLittleEndian)). - If newByteLength = currentByteLength, return
undefined . - If newByteLength < currentByteLength or
newByteLength > O.[[ArrayBufferMaxByteLength]], throw a
RangeError exception. - Let byteLengthDelta be newByteLength - currentByteLength.
- If it is impossible to create a new
Shared Data Block value consisting of byteLengthDelta bytes, throw aRangeError exception. - NOTE: No new
Shared Data Block is constructed and used here. The observable behaviour of growable SharedArrayBuffers is specified by allocating amax -sizedShared Data Block at construction time, and this step captures the requirement that implementations that run out of memory must throw aRangeError . - Let readByteLengthRawBytes be
AtomicCompareExchangeInSharedBlock (byteLengthBlock, 0, 8, currentByteLengthRawBytes, newByteLengthRawBytes). - If
ByteListEqual (readByteLengthRawBytes, currentByteLengthRawBytes) istrue , returnundefined . - Set currentByteLengthRawBytes to readByteLengthRawBytes.
Spurious failures of the compare-exchange to update the length are prohibited. If the
bounds checking for the new length passes and the implementation is not out of
memory, a
Parallel calls to SharedArrayBuffer.prototype.grow are totally ordered. For example,
consider two racing calls: sab.grow(10) and sab.grow(20).
One of the two calls is guaranteed to win the race. The call to
sab.grow(10) will never shrink sab even if
sab.grow(20) happened first; in that case it will instead throw a
RangeError.
25.2.5.4 get SharedArrayBuffer.prototype.growable
SharedArrayBuffer.prototype.growable is an
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[ArrayBufferData]]). - If
IsSharedArrayBuffer (O) isfalse , throw aTypeError exception. - If
IsFixedLengthArrayBuffer (O) isfalse , returntrue ; otherwise returnfalse .
25.2.5.5 get SharedArrayBuffer.prototype.maxByteLength
SharedArrayBuffer.prototype.maxByteLength is an
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[ArrayBufferData]]). - If
IsSharedArrayBuffer (O) isfalse , throw aTypeError exception. - If
IsFixedLengthArrayBuffer (O) istrue , then- Let length be O.[[ArrayBufferByteLength]].
- Else,
- Let length be O.[[ArrayBufferMaxByteLength]].
- Return
𝔽 (length).
25.2.5.6 SharedArrayBuffer.prototype.slice ( start, end )
This method performs the following steps when called:
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[ArrayBufferData]]). - If
IsSharedArrayBuffer (O) isfalse , throw aTypeError exception. - Let len be
ArrayBufferByteLength (O,seq-cst ). - Let relativeStart be ?
ToIntegerOrInfinity (start). - If relativeStart = -∞, let first be 0.
- Else if relativeStart < 0, let first be
max (len + relativeStart, 0). - Else, let first be
min (relativeStart, len). - If end is
undefined , let relativeEnd be len; else let relativeEnd be ?ToIntegerOrInfinity (end). - If relativeEnd = -∞, let final be 0.
- Else if relativeEnd < 0, let final be
max (len + relativeEnd, 0). - Else, let final be
min (relativeEnd, len). - Let newLen be
max (final - first, 0). - Let ctor be ?
SpeciesConstructor (O,%SharedArrayBuffer% ). - Let new be ?
Construct (ctor, «𝔽 (newLen) »). - Perform ?
RequireInternalSlot (new, [[ArrayBufferData]]). - If
IsSharedArrayBuffer (new) isfalse , throw aTypeError exception. - If new.[[ArrayBufferData]] is O.[[ArrayBufferData]], throw a
TypeError exception. - If
ArrayBufferByteLength (new,seq-cst ) < newLen, throw aTypeError exception. - Let fromBuf be O.[[ArrayBufferData]].
- Let toBuf be new.[[ArrayBufferData]].
- Perform
CopyDataBlockBytes (toBuf, 0, fromBuf, first, newLen). - Return new.
25.2.5.7 SharedArrayBuffer.prototype [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
25.2.6 Properties of SharedArrayBuffer Instances
SharedArrayBuffer instances inherit properties from the
SharedArrayBuffer instances, unlike ArrayBuffer instances, are never detached.
25.2.7 Growable SharedArrayBuffer Guidelines
The following are guidelines for ECMAScript programmers working with
We recommend that programs be tested in their deployment environments where possible. The amount of available physical memory differ greatly between hardware devices. Similarly, virtual memory subsystems also differ greatly between hardware devices as well as operating systems. An application that runs without out-of-memory errors on a 64-bit desktop web browser could run out of memory on a 32-bit mobile web browser.
When choosing a value for the
Please note that successfully constructing a
Not all loads of a u8[idx], are not synchronizing. In general, in the absence of explicit
synchronization, one property access being in-bound does not imply a subsequent property
access in the same length and byteLength getters on
SharedArrayBuffer,
The following are guidelines for ECMAScript implementers implementing
We recommend
Because grow operations can happen in parallel with memory accesses on a
Grown memory must appear zeroed from the moment of its creation, including to any racy accesses in parallel. This can be accomplished via zero-filled-on-demand virtual memory pages, or careful synchronization if manually zeroing memory.
In practice it is difficult to implement
25.3 DataView Objects
25.3.1 Abstract Operations For DataView Objects
25.3.1.1 DataView With Buffer Witness Records
A DataView With Buffer
Witness Record is a
DataView With Buffer Witness Records have the fields listed in
| Field Name | Value | Meaning |
|---|---|---|
| [[Object]] | a DataView | The DataView object whose buffer's byte length is loaded. |
| [[CachedBufferByteLength]] |
a non-negative |
The byte length of the object's [[ViewedArrayBuffer]] when the |
25.3.1.2 MakeDataViewWithBufferWitnessRecord ( obj, order )
The abstract operation MakeDataViewWithBufferWitnessRecord takes arguments obj (a
DataView) and order (
- Let buffer be obj.[[ViewedArrayBuffer]].
- If
IsDetachedBuffer (buffer) istrue , then- Let byteLength be
detached .
- Let byteLength be
- Else,
- Let byteLength be
ArrayBufferByteLength (buffer, order).
- Let byteLength be
- Return the
DataView With Buffer Witness Record { [[Object]]: obj, [[CachedBufferByteLength]]: byteLength }.
25.3.1.3 GetViewByteLength ( viewRecord )
The abstract operation GetViewByteLength takes argument viewRecord (a
Assert :IsViewOutOfBounds (viewRecord) isfalse .- Let view be viewRecord.[[Object]].
- If view.[[ByteLength]] is not
auto , return view.[[ByteLength]]. Assert :IsFixedLengthArrayBuffer (view.[[ViewedArrayBuffer]]) isfalse .- Let byteOffset be view.[[ByteOffset]].
- Let byteLength be viewRecord.[[CachedBufferByteLength]].
Assert : byteLength is notdetached .- Return byteLength - byteOffset.
25.3.1.4 IsViewOutOfBounds ( viewRecord )
The abstract operation IsViewOutOfBounds takes argument viewRecord (a
- Let view be viewRecord.[[Object]].
- Let bufferByteLength be viewRecord.[[CachedBufferByteLength]].
Assert :IsDetachedBuffer (view.[[ViewedArrayBuffer]]) istrue if and only if bufferByteLength isdetached .- If bufferByteLength is
detached , returntrue . - Let byteOffsetStart be view.[[ByteOffset]].
- If view.[[ByteLength]] is
auto , then- Let byteOffsetEnd be bufferByteLength.
- Else,
- Let byteOffsetEnd be byteOffsetStart + view.[[ByteLength]].
- If byteOffsetStart > bufferByteLength or
byteOffsetEnd > bufferByteLength, return
true . - NOTE: 0-length DataViews are not considered out-of-bounds.
- Return
false .
25.3.1.5 GetViewValue ( view, requestIndex, isLittleEndian, type )
The abstract operation GetViewValue takes arguments view (an
- Perform ?
RequireInternalSlot (view, [[DataView]]). Assert : view has a [[ViewedArrayBuffer]] internal slot.- Let getIndex be ?
ToIndex (requestIndex). - Set isLittleEndian to
ToBoolean (isLittleEndian). - Let viewOffset be view.[[ByteOffset]].
- Let viewRecord be
MakeDataViewWithBufferWitnessRecord (view,unordered ). - NOTE: Bounds checking is not a synchronizing operation when view's
backing buffer is a
growable SharedArrayBuffer . - If
IsViewOutOfBounds (viewRecord) istrue , throw aTypeError exception. - Let viewSize be
GetViewByteLength (viewRecord). - Let elementSize be the Element Size value specified in
Table 75 for Element Type type. - If getIndex + elementSize > viewSize, throw a
RangeError exception. - Let bufferIndex be getIndex + viewOffset.
- Return
GetValueFromBuffer (view.[[ViewedArrayBuffer]], bufferIndex, type,false ,unordered , isLittleEndian).
25.3.1.6 SetViewValue ( view, requestIndex, isLittleEndian, type, value )
The abstract operation SetViewValue takes arguments view (an
- Perform ?
RequireInternalSlot (view, [[DataView]]). Assert : view has a [[ViewedArrayBuffer]] internal slot.- Let getIndex be ?
ToIndex (requestIndex). - If
IsBigIntElementType (type) istrue , let numberValue be ?ToBigInt (value). - Otherwise, let numberValue be ?
ToNumber (value). - Set isLittleEndian to
ToBoolean (isLittleEndian). - Let viewOffset be view.[[ByteOffset]].
- Let viewRecord be
MakeDataViewWithBufferWitnessRecord (view,unordered ). - NOTE: Bounds checking is not a synchronizing operation when view's
backing buffer is a
growable SharedArrayBuffer . - If
IsViewOutOfBounds (viewRecord) istrue , throw aTypeError exception. - Let viewSize be
GetViewByteLength (viewRecord). - Let elementSize be the Element Size value specified in
Table 75 for Element Type type. - If getIndex + elementSize > viewSize, throw a
RangeError exception. - Let bufferIndex be getIndex + viewOffset.
- Perform
SetValueInBuffer (view.[[ViewedArrayBuffer]], bufferIndex, type, numberValue,false ,unordered , isLittleEndian). - Return
undefined .
25.3.2 The DataView Constructor
The DataView
- is %DataView%.
- is the initial value of the
"DataView" property of theglobal object . - creates and initializes a new DataView when called as a
constructor . - is not intended to be called as a function and will throw an exception when called in that manner.
- may be used as the value of an
extendsclause of a class definition. Subclassconstructors that intend to inherit the specified DataView behaviour must include asupercall to the DataViewconstructor to create and initialize subclass instances with the internal state necessary to support theDataView.prototypebuilt-in methods.
25.3.2.1 DataView ( buffer [ , byteOffset [ , byteLength ] ] )
This function performs the following steps when called:
- If NewTarget is
undefined , throw aTypeError exception. - Perform ?
RequireInternalSlot (buffer, [[ArrayBufferData]]). - Let offset be ?
ToIndex (byteOffset). - If
IsDetachedBuffer (buffer) istrue , throw aTypeError exception. - Let bufferByteLength be
ArrayBufferByteLength (buffer,seq-cst ). - If offset > bufferByteLength, throw a
RangeError exception. - Let bufferIsFixedLength be
IsFixedLengthArrayBuffer (buffer). - If byteLength is
undefined , then- If bufferIsFixedLength is
true , then- Let viewByteLength be bufferByteLength - offset.
- Else,
- Let viewByteLength be
auto .
- Let viewByteLength be
- If bufferIsFixedLength is
- Else,
- Let viewByteLength be ?
ToIndex (byteLength). - If offset + viewByteLength >
bufferByteLength, throw a
RangeError exception.
- Let viewByteLength be ?
- Let O be ?
OrdinaryCreateFromConstructor (NewTarget,"%DataView.prototype%" , « [[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], [[ByteOffset]] »). - If
IsDetachedBuffer (buffer) istrue , throw aTypeError exception. - Set bufferByteLength to
ArrayBufferByteLength (buffer,seq-cst ). - If offset > bufferByteLength, throw a
RangeError exception. - If byteLength is not
undefined , then- If offset + viewByteLength >
bufferByteLength, throw a
RangeError exception.
- If offset + viewByteLength >
bufferByteLength, throw a
- Set O.[[ViewedArrayBuffer]] to buffer.
- Set O.[[ByteLength]] to viewByteLength.
- Set O.[[ByteOffset]] to offset.
- Return O.
25.3.3 Properties of the DataView Constructor
The DataView
- has a [[Prototype]] internal slot whose value is
%Function.prototype% . - has the following properties:
25.3.3.1 DataView.prototype
The initial value of DataView.prototype is the
This property has the attributes { [[Writable]]:
25.3.4 Properties of the DataView Prototype Object
The DataView prototype object:
- is %DataView.prototype%.
- has a [[Prototype]] internal slot whose value is
%Object.prototype% . - is an
ordinary object . - does not have a [[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], or [[ByteOffset]] internal slot.
25.3.4.1 get DataView.prototype.buffer
DataView.prototype.buffer is an
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[DataView]]). Assert : O has a [[ViewedArrayBuffer]] internal slot.- Let buffer be O.[[ViewedArrayBuffer]].
- Return buffer.
25.3.4.2 get DataView.prototype.byteLength
DataView.prototype.byteLength is an
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[DataView]]). Assert : O has a [[ViewedArrayBuffer]] internal slot.- Let viewRecord be
MakeDataViewWithBufferWitnessRecord (O,seq-cst ). - If
IsViewOutOfBounds (viewRecord) istrue , throw aTypeError exception. - Let size be
GetViewByteLength (viewRecord). - Return
𝔽 (size).
25.3.4.3 get DataView.prototype.byteOffset
DataView.prototype.byteOffset is an
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[DataView]]). Assert : O has a [[ViewedArrayBuffer]] internal slot.- Let viewRecord be
MakeDataViewWithBufferWitnessRecord (O,seq-cst ). - If
IsViewOutOfBounds (viewRecord) istrue , throw aTypeError exception. - Let offset be O.[[ByteOffset]].
- Return
𝔽 (offset).
25.3.4.4 DataView.prototype.constructor
The initial value of DataView.prototype.constructor is
25.3.4.5 DataView.prototype.getBigInt64 ( byteOffset [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - Return ?
GetViewValue (view, byteOffset, littleEndian,bigint64 ).
25.3.4.6 DataView.prototype.getBigUint64 ( byteOffset [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - Return ?
GetViewValue (view, byteOffset, littleEndian,biguint64 ).
25.3.4.7 DataView.prototype.getFloat16 ( byteOffset [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
GetViewValue (view, byteOffset, littleEndian,float16 ).
25.3.4.8 DataView.prototype.getFloat32 ( byteOffset [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
GetViewValue (view, byteOffset, littleEndian,float32 ).
25.3.4.9 DataView.prototype.getFloat64 ( byteOffset [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
GetViewValue (view, byteOffset, littleEndian,float64 ).
25.3.4.10 DataView.prototype.getInt8 ( byteOffset )
This method performs the following steps when called:
- Let view be the
this value. - Return ?
GetViewValue (view, byteOffset,true ,int8 ).
25.3.4.11 DataView.prototype.getInt16 ( byteOffset [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
GetViewValue (view, byteOffset, littleEndian,int16 ).
25.3.4.12 DataView.prototype.getInt32 ( byteOffset [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
GetViewValue (view, byteOffset, littleEndian,int32 ).
25.3.4.13 DataView.prototype.getUint8 ( byteOffset )
This method performs the following steps when called:
- Let view be the
this value. - Return ?
GetViewValue (view, byteOffset,true ,uint8 ).
25.3.4.14 DataView.prototype.getUint16 ( byteOffset [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
GetViewValue (view, byteOffset, littleEndian,uint16 ).
25.3.4.15 DataView.prototype.getUint32 ( byteOffset [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
GetViewValue (view, byteOffset, littleEndian,uint32 ).
25.3.4.16 DataView.prototype.setBigInt64 ( byteOffset, value [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - Return ?
SetViewValue (view, byteOffset, littleEndian,bigint64 , value).
25.3.4.17 DataView.prototype.setBigUint64 ( byteOffset, value [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - Return ?
SetViewValue (view, byteOffset, littleEndian,biguint64 , value).
25.3.4.18 DataView.prototype.setFloat16 ( byteOffset, value [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
SetViewValue (view, byteOffset, littleEndian,float16 , value).
25.3.4.19 DataView.prototype.setFloat32 ( byteOffset, value [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
SetViewValue (view, byteOffset, littleEndian,float32 , value).
25.3.4.20 DataView.prototype.setFloat64 ( byteOffset, value [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
SetViewValue (view, byteOffset, littleEndian,float64 , value).
25.3.4.21 DataView.prototype.setInt8 ( byteOffset, value )
This method performs the following steps when called:
- Let view be the
this value. - Return ?
SetViewValue (view, byteOffset,true ,int8 , value).
25.3.4.22 DataView.prototype.setInt16 ( byteOffset, value [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
SetViewValue (view, byteOffset, littleEndian,int16 , value).
25.3.4.23 DataView.prototype.setInt32 ( byteOffset, value [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
SetViewValue (view, byteOffset, littleEndian,int32 , value).
25.3.4.24 DataView.prototype.setUint8 ( byteOffset, value )
This method performs the following steps when called:
- Let view be the
this value. - Return ?
SetViewValue (view, byteOffset,true ,uint8 , value).
25.3.4.25 DataView.prototype.setUint16 ( byteOffset, value [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
SetViewValue (view, byteOffset, littleEndian,uint16 , value).
25.3.4.26 DataView.prototype.setUint32 ( byteOffset, value [ , littleEndian ] )
This method performs the following steps when called:
- Let view be the
this value. - If littleEndian is not present, set littleEndian to
false . - Return ?
SetViewValue (view, byteOffset, littleEndian,uint32 , value).
25.3.4.27 DataView.prototype [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
25.3.5 Properties of DataView Instances
DataView instances are
The value of the [[DataView]] internal slot is not used within
this specification. The simple presence of that internal slot is used within the
specification to identify objects created using the DataView
25.4 The Atomics Object
The Atomics object:
- is %Atomics%.
- is the initial value of the
"Atomics" property of theglobal object . - is an
ordinary object . - has a [[Prototype]] internal slot whose value is
%Object.prototype% . - does not have a [[Construct]] internal method; it cannot be used as a
constructor with thenewoperator. - does not have a [[Call]] internal method; it cannot be invoked as a function.
The Atomics object provides functions that operate indivisibly (atomically) on shared memory array
cells as well as functions that let
For informative guidelines for programming and implementing shared memory in ECMAScript,
please see the notes at the end of the
25.4.1 Waiter Record
A Waiter Record is a Atomics.wait or Atomics.waitAsync.
A Waiter Record has fields listed in
| Field Name | Value | Meaning |
|---|---|---|
| [[AgentSignifier]] |
an |
The Atomics.wait or Atomics.waitAsync.
|
| [[PromiseCapability]] |
a |
If denoting a call to Atomics.waitAsync, the resulting promise,
otherwise |
| [[TimeoutTime]] |
a non-negative |
The earliest time by which timeout may be triggered; computed using
|
| [[Result]] |
|
The return value of the call. |
25.4.2 WaiterList Records
A WaiterList Record is used to explain
waiting and notification of Atomics.wait,
Atomics.waitAsync, and Atomics.notify.
A WaiterList Record has fields listed in
| Field Name | Value | Meaning |
|---|---|---|
| [[Waiters]] |
a |
The calls to Atomics.wait or Atomics.waitAsync
that are waiting on the location with which this WaiterList is associated.
|
| [[MostRecentLeaveEvent]] |
a |
The event of the most recent leaving of its |
There can be multiple
The
Each WaiterList Record has a critical
section that controls exclusive access to that WaiterList Record during evaluation.
Only a single
25.4.3 Abstract Operations for Atomics
25.4.3.1 ValidateIntegerTypedArray ( typedArray, waitable )
The abstract operation ValidateIntegerTypedArray takes arguments typedArray (an
- Let taRecord be ?
ValidateTypedArray (typedArray,unordered ). - NOTE: Bounds checking is not a synchronizing operation when typedArray's
backing buffer is a
growable SharedArrayBuffer . - If waitable is
true , then- If typedArray.[[TypedArrayName]] is
neither
"Int32Array" nor"BigInt64Array" , throw aTypeError exception.
- If typedArray.[[TypedArrayName]] is
neither
- Else,
- Let type be
TypedArrayElementType (typedArray). - If
IsUnclampedIntegerElementType (type) isfalse andIsBigIntElementType (type) isfalse , throw aTypeError exception.
- Let type be
- Return taRecord.
25.4.3.2 ValidateAtomicAccess ( taRecord, requestIndex )
The abstract operation ValidateAtomicAccess takes arguments taRecord (a
- Let length be
TypedArrayLength (taRecord). - Let accessIndex be ?
ToIndex (requestIndex). Assert : accessIndex ≥ 0.- If accessIndex ≥ length, throw a
RangeError exception. - Let typedArray be taRecord.[[Object]].
- Let elementSize be
TypedArrayElementSize (typedArray). - Let offset be typedArray.[[ByteOffset]].
- Return (accessIndex × elementSize) + offset.
25.4.3.3 ValidateAtomicAccessOnIntegerTypedArray ( typedArray, requestIndex )
The abstract operation ValidateAtomicAccessOnIntegerTypedArray takes arguments
typedArray (an
- Let taRecord be ?
ValidateIntegerTypedArray (typedArray,false ). - Return ?
ValidateAtomicAccess (taRecord, requestIndex).
25.4.3.4 RevalidateAtomicAccess ( typedArray, byteIndexInBuffer )
The abstract operation RevalidateAtomicAccess takes arguments typedArray (a
- Let taRecord be
MakeTypedArrayWithBufferWitnessRecord (typedArray,unordered ). - NOTE: Bounds checking is not a synchronizing operation when typedArray's
backing buffer is a
growable SharedArrayBuffer . - If
IsTypedArrayOutOfBounds (taRecord) istrue , throw aTypeError exception. Assert : byteIndexInBuffer ≥ typedArray.[[ByteOffset]].- If byteIndexInBuffer ≥ taRecord.[[CachedBufferByteLength]], throw a
RangeError exception. - Return
unused .
25.4.3.5 GetWaiterList ( block, i )
The abstract operation GetWaiterList takes arguments block (a
Assert : i and i + 3 are valid byte offsets within the memory of block.- Return the
WaiterList Record that is referenced by the pair (block, i).
25.4.3.6 EnterCriticalSection ( WL )
The abstract operation EnterCriticalSection takes argument WL (a
Assert : Thesurrounding agent is not in thecritical section for anyWaiterList Record .- Wait until no
agent is in thecritical section for WL, then enter thecritical section for WL (without allowing any otheragent to enter). - If WL.[[MostRecentLeaveEvent]] is not
empty , then- NOTE: A WL whose
critical section has been entered at least once has aSynchronize event set byLeaveCriticalSection . - Let execution be the [[CandidateExecution]] field of the
surrounding agent 'sAgent Record . - Let eventsRecord be the
Agent Events Record of execution.[[EventsRecords]] whose [[AgentSignifier]] isAgentSignifier (). - Let enterEvent be a new
Synchronize event . - Append enterEvent to eventsRecord.[[EventList]].
- Append (WL.[[MostRecentLeaveEvent]], enterEvent) to eventsRecord.[[AgentSynchronizesWith]].
- NOTE: A WL whose
- Return
unused .
EnterCriticalSection has contention when an
25.4.3.7 LeaveCriticalSection ( WL )
The abstract operation LeaveCriticalSection takes argument WL (a
Assert : Thesurrounding agent is in thecritical section for WL.- Let execution be the [[CandidateExecution]]
field of the
surrounding agent 'sAgent Record . - Let eventsRecord be the
Agent Events Record of execution.[[EventsRecords]] whose [[AgentSignifier]] isAgentSignifier (). - Let leaveEvent be a new
Synchronize event . - Append leaveEvent to eventsRecord.[[EventList]].
- Set WL.[[MostRecentLeaveEvent]] to leaveEvent.
- Leave the
critical section for WL. - Return
unused .
25.4.3.8 AddWaiter ( WL, waiterRecord )
The abstract operation AddWaiter takes arguments WL (a
Assert : Thesurrounding agent is in thecritical section for WL.Assert : There is noWaiter Record in WL.[[Waiters]] whose [[PromiseCapability]] field is waiterRecord.[[PromiseCapability]] and whose [[AgentSignifier]] field is waiterRecord.[[AgentSignifier]].- Append waiterRecord to WL.[[Waiters]].
- Return
unused .
25.4.3.9 RemoveWaiter ( WL, waiterRecord )
The abstract operation RemoveWaiter takes arguments WL (a
Assert : Thesurrounding agent is in thecritical section for WL.Assert : WL.[[Waiters]] contains waiterRecord.- Remove waiterRecord from WL.[[Waiters]].
- Return
unused .
25.4.3.10 RemoveWaiters ( WL, c )
The abstract operation RemoveWaiters takes arguments WL (a
Assert : Thesurrounding agent is in thecritical section for WL.- Let len be the number of elements in WL.[[Waiters]].
- Let n be
min (c, len). - Let L be a
List whose elements are the first n elements of WL.[[Waiters]]. - Remove the first n elements of WL.[[Waiters]].
- Return L.
25.4.3.11 SuspendThisAgent ( WL, waiterRecord )
The abstract operation SuspendThisAgent takes arguments WL (a
Assert : Thesurrounding agent is in thecritical section for WL.Assert : WL.[[Waiters]] contains waiterRecord.- Let thisAgent be
AgentSignifier (). Assert : waiterRecord.[[AgentSignifier]] is thisAgent.Assert : waiterRecord.[[PromiseCapability]] isblocking .Assert :AgentCanSuspend () istrue .- Perform
LeaveCriticalSection (WL) and suspend thesurrounding agent until the time is waiterRecord.[[TimeoutTime]], performing the combined operation in such a way that a notification that arrives after thecritical section is exited but before the suspension takes effect is not lost. Thesurrounding agent can only wake from suspension due to a timeout or due to anotheragent callingNotifyWaiter with arguments WL and thisAgent (i.e. via a call toAtomics.notify). - Perform
EnterCriticalSection (WL). - Return
unused .
25.4.3.12 NotifyWaiter ( WL, waiterRecord )
The abstract operation NotifyWaiter takes arguments WL (a
Assert : Thesurrounding agent is in thecritical section for WL.- If waiterRecord.[[PromiseCapability]] is
blocking , then- Wake the
agent whose signifier is waiterRecord.[[AgentSignifier]] from suspension. - NOTE: This causes the
agent to resume execution inSuspendThisAgent .
- Wake the
- Else if
AgentSignifier () is waiterRecord.[[AgentSignifier]], then- Let promiseCapability be waiterRecord.[[PromiseCapability]].
- Perform !
Call (promiseCapability.[[Resolve]],undefined , « waiterRecord.[[Result]] »).
- Else,
- Perform
EnqueueResolveInAgentJob (waiterRecord.[[AgentSignifier]], waiterRecord.[[PromiseCapability]], waiterRecord.[[Result]]).
- Perform
- Return
unused .
25.4.3.13 EnqueueResolveInAgentJob ( agentSignifier, promiseCapability, resolution )
The abstract operation EnqueueResolveInAgentJob takes arguments agentSignifier (an
- Let resolveJob be a new
Job Abstract Closure with no parameters that captures agentSignifier, promiseCapability, and resolution and performs the following steps when called:Assert :AgentSignifier () is agentSignifier.- Perform !
Call (promiseCapability.[[Resolve]],undefined , « resolution »). - Return
unused .
- Let realmInTargetAgent be !
GetFunctionRealm (promiseCapability.[[Resolve]]). Assert : agentSignifier is realmInTargetAgent.[[AgentSignifier]].- Perform
HostEnqueueGenericJob (resolveJob, realmInTargetAgent). - Return
unused .
25.4.3.14 DoWait ( mode, typedArray, index, value, timeout )
The abstract operation DoWait takes arguments mode (
- Let taRecord be ?
ValidateIntegerTypedArray (typedArray,true ). - Let buffer be taRecord.[[Object]].[[ViewedArrayBuffer]].
- If
IsSharedArrayBuffer (buffer) isfalse , throw aTypeError exception. - Let i be ?
ValidateAtomicAccess (taRecord, index). - Let arrayTypeName be typedArray.[[TypedArrayName]].
- If arrayTypeName is
"BigInt64Array" , let v be ?ToBigInt64 (value). - Else, let v be ?
ToInt32 (value). - Let q be ?
ToNumber (timeout). - If q is either
NaN or+∞ 𝔽, let t be +∞; else if q is-∞ 𝔽, let t be 0; else let t bemax (ℝ (q), 0). - If mode is
sync andAgentCanSuspend () isfalse , throw aTypeError exception. - Let block be buffer.[[ArrayBufferData]].
- Let offset be typedArray.[[ByteOffset]].
- Let byteIndexInBuffer be (i × 4) + offset.
- Let WL be
GetWaiterList (block, byteIndexInBuffer). - If mode is
sync , then- Let promiseCapability be
blocking . - Let resultObject be
undefined .
- Let promiseCapability be
- Else,
- Let promiseCapability be !
NewPromiseCapability (%Promise% ). - Let resultObject be
OrdinaryObjectCreate (%Object.prototype% ).
- Let promiseCapability be !
- Perform
EnterCriticalSection (WL). - Let elementType be
TypedArrayElementType (typedArray). - Let w be
GetValueFromBuffer (buffer, byteIndexInBuffer, elementType,true ,seq-cst ). - If v ≠ w, then
- Perform
LeaveCriticalSection (WL). - If mode is
sync , return"not-equal" . - Perform !
CreateDataPropertyOrThrow (resultObject,"async" ,false ). - Perform !
CreateDataPropertyOrThrow (resultObject,"value" ,"not-equal" ). - Return resultObject.
- Perform
- If t = 0 and mode is
async , then- NOTE: There is no special handling of synchronous immediate timeouts. Asynchronous immediate timeouts have special handling in order to fail fast and avoid unnecessary Promise jobs.
- Perform
LeaveCriticalSection (WL). - Perform !
CreateDataPropertyOrThrow (resultObject,"async" ,false ). - Perform !
CreateDataPropertyOrThrow (resultObject,"value" ,"timed-out" ). - Return resultObject.
- Let thisAgent be
AgentSignifier (). - Let now be the
time value (UTC) identifying the current time. - Let additionalTimeout be an
implementation-defined non-negativemathematical value . - Let timeoutTime be
ℝ (now) + t + additionalTimeout. - NOTE: When t is +∞, timeoutTime is also +∞.
- Let waiterRecord be a new
Waiter Record { [[AgentSignifier]]: thisAgent, [[PromiseCapability]]: promiseCapability, [[TimeoutTime]]: timeoutTime, [[Result]]:"ok" }. - Perform
AddWaiter (WL, waiterRecord). - If mode is
sync , then- Perform
SuspendThisAgent (WL, waiterRecord).
- Perform
- Else if timeoutTime is
finite , then- Perform
EnqueueAtomicsWaitAsyncTimeoutJob (WL, waiterRecord).
- Perform
- Perform
LeaveCriticalSection (WL). - If mode is
sync , return waiterRecord.[[Result]]. - Perform !
CreateDataPropertyOrThrow (resultObject,"async" ,true ). - Perform !
CreateDataPropertyOrThrow (resultObject,"value" , promiseCapability.[[Promise]]). - Return resultObject.
additionalTimeout allows implementations to pad timeouts as necessary, such as for reducing power consumption or coarsening timer resolution to mitigate timing attacks. This value may differ from call to call of DoWait.
25.4.3.15 EnqueueAtomicsWaitAsyncTimeoutJob ( WL, waiterRecord )
The abstract operation EnqueueAtomicsWaitAsyncTimeoutJob takes arguments WL (a
- Let timeoutJob be a new
Job Abstract Closure with no parameters that captures WL and waiterRecord and performs the following steps when called:- Perform
EnterCriticalSection (WL). - If WL.[[Waiters]] contains
waiterRecord, then
- Let timeOfJobExecution be the
time value (UTC) identifying the current time. Assert :ℝ (timeOfJobExecution) ≥ waiterRecord.[[TimeoutTime]] (ignoring potential non-monotonicity oftime values ).- Set waiterRecord.[[Result]] to
"timed-out" . - Perform
RemoveWaiter (WL, waiterRecord). - Perform
NotifyWaiter (WL, waiterRecord).
- Let timeOfJobExecution be the
- Perform
LeaveCriticalSection (WL). - Return
unused .
- Perform
- Let now be the
time value (UTC) identifying the current time. - Let currentRealm be
the current Realm Record . - Perform
HostEnqueueTimeoutJob (timeoutJob, currentRealm,𝔽 (waiterRecord.[[TimeoutTime]]) - now). - Return
unused .
25.4.3.16 AtomicCompareExchangeInSharedBlock ( block, byteIndexInBuffer, elementSize, expectedBytes, replacementBytes )
The abstract operation AtomicCompareExchangeInSharedBlock takes arguments block (a
- Let execution be the [[CandidateExecution]]
field of the
surrounding agent 'sAgent Record . - Let eventsRecord be the
Agent Events Record of execution.[[EventsRecords]] whose [[AgentSignifier]] isAgentSignifier (). - Let rawBytesRead be a
List of length elementSize whose elements are nondeterministically chosenbyte values . - NOTE: In implementations, rawBytesRead is the result of a load-link, of a
load-exclusive, or of an operand of a read-modify-write instruction on the
underlying hardware. The nondeterminism is a semantic prescription of the
memory model to describe observable behaviour of hardware with weak consistency. - NOTE: The comparison of the expected value and the read value is performed outside
of the
read-modify-write modification function to avoid needlessly strong synchronization when the expected value is not equal to the read value. - If
ByteListEqual (rawBytesRead, expectedBytes) istrue , then- Let second be a new
read-modify-write modification function with parameters (oldBytes, newBytes) that captures nothing and performs the following steps atomically when called:- Return newBytes.
- Let event be
ReadModifyWriteSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndexInBuffer, [[ElementSize]]: elementSize, [[Payload]]: replacementBytes, [[ModifyOp]]: second }.
- Let second be a new
- Else,
- Let event be
ReadSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndexInBuffer, [[ElementSize]]: elementSize }.
- Let event be
- Append event to eventsRecord.[[EventList]].
- Append
Chosen Value Record { [[Event]]: event, [[ChosenValue]]: rawBytesRead } to execution.[[ChosenValues]]. - Return rawBytesRead.
25.4.3.17 AtomicReadModifyWrite ( typedArray, index, value, op )
The abstract operation AtomicReadModifyWrite takes arguments typedArray (an
- Let byteIndexInBuffer be ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index). - If typedArray.[[ContentType]] is
bigint , let v be ?ToBigInt (value). - Otherwise, let v be
𝔽 (?ToIntegerOrInfinity (value)). - Perform ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer). - Let buffer be typedArray.[[ViewedArrayBuffer]].
- Let elementType be
TypedArrayElementType (typedArray). - Return
GetModifySetValueInBuffer (buffer, byteIndexInBuffer, elementType, v, op).
25.4.3.18 ByteListBitwiseOp ( op, xBytes, yBytes )
The abstract operation ByteListBitwiseOp takes arguments op (&,
^, or |), xBytes (a
Assert : xBytes and yBytes have the same number of elements.- Let result be a new empty
List . - Let i be 0.
- For each element xByte of xBytes, do
- Let yByte be yBytes[i].
- If op is
&, then- Let resultByte be the result of applying the bitwise AND operation to xByte and yByte.
- Else if op is
^, then- Let resultByte be the result of applying the bitwise exclusive OR (XOR) operation to xByte and yByte.
- Else,
Assert : op is|.- Let resultByte be the result of applying the bitwise inclusive OR operation to xByte and yByte.
- Set i to i + 1.
- Append resultByte to result.
- Return result.
25.4.3.19 ByteListEqual ( xBytes, yBytes )
The abstract operation ByteListEqual takes arguments xBytes (a
- If xBytes and yBytes do not have the same number of elements,
return
false . - Let i be 0.
- For each element xByte of xBytes, do
- Let yByte be yBytes[i].
- If xByte ≠ yByte, return
false . - Set i to i + 1.
- Return
true .
25.4.4 Atomics.add ( typedArray, index, value )
This function performs the following steps when called:
- Let add be a new
read-modify-write modification function with parameters (xBytes, yBytes) that captures typedArray and performs the following steps atomically when called:- Let type be
TypedArrayElementType (typedArray). - Let isLittleEndian be the value of the [[LittleEndian]] field of the
surrounding agent 'sAgent Record . - Let x be
RawBytesToNumeric (type, xBytes, isLittleEndian). - Let y be
RawBytesToNumeric (type, yBytes, isLittleEndian). - If x
is a Number , then- Let sum be
Number::add (x, y).
- Let sum be
- Else,
Assert : xis a BigInt .- Let sum be
BigInt::add (x, y).
- Let sumBytes be
NumericToRawBytes (type, sum, isLittleEndian). Assert : sumBytes, xBytes, and yBytes have the same number of elements.- Return sumBytes.
- Let type be
- Return ?
AtomicReadModifyWrite (typedArray, index, value, add).
25.4.5 Atomics.and ( typedArray, index, value )
This function performs the following steps when called:
- Let and be a new
read-modify-write modification function with parameters (xBytes, yBytes) that captures nothing and performs the following steps atomically when called:- Return
ByteListBitwiseOp (&, xBytes, yBytes).
- Return
- Return ?
AtomicReadModifyWrite (typedArray, index, value, and).
25.4.6 Atomics.compareExchange ( typedArray, index, expectedValue, replacementValue )
This function performs the following steps when called:
- Let byteIndexInBuffer be ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index). - Let buffer be typedArray.[[ViewedArrayBuffer]].
- Let block be buffer.[[ArrayBufferData]].
- If typedArray.[[ContentType]] is
bigint , then - Else,
- Let expected be
𝔽 (?ToIntegerOrInfinity (expectedValue)). - Let replacement be
𝔽 (?ToIntegerOrInfinity (replacementValue)).
- Let expected be
- Perform ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer). - Let elementType be
TypedArrayElementType (typedArray). - Let elementSize be
TypedArrayElementSize (typedArray). - Let isLittleEndian be the value of the [[LittleEndian]] field of the
surrounding agent 'sAgent Record . - Let expectedBytes be
NumericToRawBytes (elementType, expected, isLittleEndian). - Let replacementBytes be
NumericToRawBytes (elementType, replacement, isLittleEndian). - If
IsSharedArrayBuffer (buffer) istrue , then- Let rawBytesRead be
AtomicCompareExchangeInSharedBlock (block, byteIndexInBuffer, elementSize, expectedBytes, replacementBytes).
- Let rawBytesRead be
- Else,
- Let rawBytesRead be a
List of length elementSize whose elements are the sequence of elementSize bytes starting with block[byteIndexInBuffer]. - If
ByteListEqual (rawBytesRead, expectedBytes) istrue , then- Store the individual bytes of replacementBytes into block, starting at block[byteIndexInBuffer].
- Let rawBytesRead be a
- Return
RawBytesToNumeric (elementType, rawBytesRead, isLittleEndian).
25.4.7 Atomics.exchange ( typedArray, index, value )
This function performs the following steps when called:
- Let second be a new
read-modify-write modification function with parameters (oldBytes, newBytes) that captures nothing and performs the following steps atomically when called:- Return newBytes.
- Return ?
AtomicReadModifyWrite (typedArray, index, value, second).
25.4.8 Atomics.isLockFree ( size )
This function performs the following steps when called:
- Let n be ?
ToIntegerOrInfinity (size). - Let AR be the
Agent Record of thesurrounding agent . - If n = 1, return AR.[[IsLockFree1]].
- If n = 2, return AR.[[IsLockFree2]].
- If n = 4, return
true . - If n = 8, return AR.[[IsLockFree8]].
- Return
false .
This function is an optimization primitive. The intuition is that if the atomic step of
an atomic primitive (compareExchange, load,
store, add, sub, and,
or, xor, or exchange) on a datum of size
n bytes will be performed without the Atomics.isLockFree(n) will return
Atomics.isLockFree(4) always returns
Regardless of the value returned by this function, all atomic operations are guaranteed to be atomic. For example, they will never have a visible operation take place in the middle of the operation (e.g., "tearing").
25.4.9 Atomics.load ( typedArray, index )
This function performs the following steps when called:
- Let byteIndexInBuffer be ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index). - Perform ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer). - Let buffer be typedArray.[[ViewedArrayBuffer]].
- Let elementType be
TypedArrayElementType (typedArray). - Return
GetValueFromBuffer (buffer, byteIndexInBuffer, elementType,true ,seq-cst ).
25.4.10 Atomics.or ( typedArray, index, value )
This function performs the following steps when called:
- Let or be a new
read-modify-write modification function with parameters (xBytes, yBytes) that captures nothing and performs the following steps atomically when called:- Return
ByteListBitwiseOp (|, xBytes, yBytes).
- Return
- Return ?
AtomicReadModifyWrite (typedArray, index, value, or).
25.4.11 Atomics.store ( typedArray, index, value )
This function performs the following steps when called:
- Let byteIndexInBuffer be ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index). - If typedArray.[[ContentType]] is
bigint , let v be ?ToBigInt (value). - Otherwise, let v be
𝔽 (?ToIntegerOrInfinity (value)). - Perform ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer). - Let buffer be typedArray.[[ViewedArrayBuffer]].
- Let elementType be
TypedArrayElementType (typedArray). - Perform
SetValueInBuffer (buffer, byteIndexInBuffer, elementType, v,true ,seq-cst ). - Return v.
25.4.12 Atomics.sub ( typedArray, index, value )
This function performs the following steps when called:
- Let subtract be a new
read-modify-write modification function with parameters (xBytes, yBytes) that captures typedArray and performs the following steps atomically when called:- Let type be
TypedArrayElementType (typedArray). - Let isLittleEndian be the value of the [[LittleEndian]] field of the
surrounding agent 'sAgent Record . - Let x be
RawBytesToNumeric (type, xBytes, isLittleEndian). - Let y be
RawBytesToNumeric (type, yBytes, isLittleEndian). - If x
is a Number , then- Let difference be
Number::subtract (x, y).
- Let difference be
- Else,
Assert : xis a BigInt .- Let difference be
BigInt::subtract (x, y).
- Let differenceBytes be
NumericToRawBytes (type, difference, isLittleEndian). Assert : differenceBytes, xBytes, and yBytes have the same number of elements.- Return differenceBytes.
- Let type be
- Return ?
AtomicReadModifyWrite (typedArray, index, value, subtract).
25.4.13 Atomics.wait ( typedArray, index, value, timeout )
This function puts the
It performs the following steps when called:
- Return ?
DoWait (sync , typedArray, index, value, timeout).
25.4.14 Atomics.waitAsync ( typedArray, index, value, timeout )
This function returns a Promise that is resolved when the calling
It performs the following steps when called:
- Return ?
DoWait (async , typedArray, index, value, timeout).
25.4.15 Atomics.notify ( typedArray, index, count )
This function notifies some
It performs the following steps when called:
- Let taRecord be ?
ValidateIntegerTypedArray (typedArray,true ). - Let byteIndexInBuffer be ?
ValidateAtomicAccess (taRecord, index). - If count is
undefined , then- Let c be +∞.
- Else,
- Let intCount be ?
ToIntegerOrInfinity (count). - Let c be
max (intCount, 0).
- Let intCount be ?
- Let buffer be typedArray.[[ViewedArrayBuffer]].
- Let block be buffer.[[ArrayBufferData]].
- If
IsSharedArrayBuffer (buffer) isfalse , return+0 𝔽. - Let WL be
GetWaiterList (block, byteIndexInBuffer). - Perform
EnterCriticalSection (WL). - Let S be
RemoveWaiters (WL, c). - For each element W of S, do
- Perform
NotifyWaiter (WL, W).
- Perform
- Perform
LeaveCriticalSection (WL). - Let n be the number of elements in S.
- Return
𝔽 (n).
25.4.16 Atomics.xor ( typedArray, index, value )
This function performs the following steps when called:
- Let xor be a new
read-modify-write modification function with parameters (xBytes, yBytes) that captures nothing and performs the following steps atomically when called:- Return
ByteListBitwiseOp (^, xBytes, yBytes).
- Return
- Return ?
AtomicReadModifyWrite (typedArray, index, value, xor).
25.4.17 Atomics [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
25.5 The JSON Object
The JSON object:
- is %JSON%.
- is the initial value of the
"JSON" property of theglobal object . - is an
ordinary object . - contains two functions,
parseandstringify, that are used to parse and construct JSON texts. - has a [[Prototype]] internal slot whose value is
%Object.prototype% . - does not have a [[Construct]] internal method; it cannot be used as a
constructor with thenewoperator. - does not have a [[Call]] internal method; it cannot be invoked as a function.
The JSON Data Interchange Format is defined in ECMA-404. The JSON interchange format used in this
specification is exactly that described by ECMA-404. Conforming implementations of
JSON.parse and JSON.stringify must support the exact interchange format
described in the ECMA-404 specification without any deletions or extensions to the format.
25.5.1 JSON.parse ( text [ , reviver ] )
This function parses a JSON text (a JSON-formatted String) and produces an
The optional reviver parameter is a function that takes two parameters, key
and value. It can filter and transform the results. It is called with each of the
key/value pairs produced by the parse, and its return value is used
instead of the original value. If it returns what it received, the structure is not modified. If
it returns
- Let jsonString be ?
ToString (text). - Let unfiltered be ?
ParseJSON (jsonString). - If
IsCallable (reviver) istrue , then- Let root be
OrdinaryObjectCreate (%Object.prototype% ). - Let rootName be the empty String.
- Perform !
CreateDataPropertyOrThrow (root, rootName, unfiltered). - Return ?
InternalizeJSONProperty (root, rootName, reviver).
- Let root be
- Else,
- Return unfiltered.
The
25.5.1.1 ParseJSON ( text )
The abstract operation ParseJSON takes argument text (a String) and returns either
a
- If
StringToCodePoints (text) is not a valid JSON text as specified in ECMA-404, throw aSyntaxError exception. - Let scriptString be the
string-concatenation of"(" , text, and");" . - Let script be
ParseText (scriptString,Script ). - NOTE: The
early error rules defined in13.2.5.1 have special handling for the above invocation ofParseText . Assert : script is aParse Node .- Let result be !
Evaluation of script. - NOTE: The
PropertyDefinitionEvaluation semantics defined in13.2.5.5 have special handling for the above evaluation. Assert : result is either a String, a Number, a Boolean, an Object that is defined by either anArrayLiteral or anObjectLiteral , ornull .- Return result.
It is not permitted for a conforming implementation of JSON.parse to extend the
JSON grammars. If an implementation wishes to support a modified or extended JSON
interchange format it must do so by defining a different parse function.
Valid JSON text is a subset of the ECMAScript
However, because
In the case where there are duplicate name Strings within an object, lexically preceding values for the same key shall be overwritten.
25.5.1.2 InternalizeJSONProperty ( holder, name, reviver )
The abstract operation InternalizeJSONProperty takes arguments holder (an Object),
name (a String), and reviver (a
This algorithm intentionally does not throw an exception if either [[Delete]] or
It performs the following steps when called:
- Let val be ?
Get (holder, name). - If val
is an Object , then- Let isArray be ?
IsArray (val). - If isArray is
true , then- Let len be ?
LengthOfArrayLike (val). - Let I be 0.
- Repeat, while I < len,
- Let prop be !
ToString (𝔽 (I)). - Let newElement be ?
InternalizeJSONProperty (val, prop, reviver). - If newElement is
undefined , then- Perform ? val.[[Delete]](prop).
- Else,
- Perform ?
CreateDataProperty (val, prop, newElement).
- Perform ?
- Set I to I + 1.
- Let prop be !
- Let len be ?
- Else,
- Let keys be ?
EnumerableOwnProperties (val,key ). - For each String P of keys, do
- Let newElement be ?
InternalizeJSONProperty (val, P, reviver). - If newElement is
undefined , then- Perform ? val.[[Delete]](P).
- Else,
- Perform ?
CreateDataProperty (val, P, newElement).
- Perform ?
- Let newElement be ?
- Let keys be ?
- Let isArray be ?
- Return ?
Call (reviver, holder, « name, val »).
25.5.2 JSON.stringify ( value [ , replacer [ , space ] ] )
This function returns a String in UTF-16 encoded JSON format representing an
It performs the following steps when called:
- Let stack be a new empty
List . - Let indent be the empty String.
- Let PropertyList be
undefined . - Let ReplacerFunction be
undefined . - If replacer
is an Object , then- If
IsCallable (replacer) istrue , then- Set ReplacerFunction to replacer.
- Else,
- Let isArray be ?
IsArray (replacer). - If isArray is
true , then- Set PropertyList to a new empty
List . - Let len be ?
LengthOfArrayLike (replacer). - Let k be 0.
- Repeat, while k < len,
- Let prop be !
ToString (𝔽 (k)). - Let v be ?
Get (replacer, prop). - Let item be
undefined . - If v
is a String , then- Set item to v.
- Else if v
is a Number , then- Set item to !
ToString (v).
- Set item to !
- Else if v
is an Object , then- If v has a [[StringData]] or [[NumberData]] internal
slot, set item to ?
ToString (v).
- If v has a [[StringData]] or [[NumberData]] internal
slot, set item to ?
- If item is not
undefined and PropertyList does not contain item, then- Append item to PropertyList.
- Set k to k + 1.
- Let prop be !
- Set PropertyList to a new empty
- Let isArray be ?
- If
- If space
is an Object , then - If space
is a Number , then- Let spaceMV be !
ToIntegerOrInfinity (space). - Set spaceMV to
min (10, spaceMV). - If spaceMV < 1, let gap be the empty String; otherwise let gap be the String value containing spaceMV occurrences of the code unit 0x0020 (SPACE).
- Let spaceMV be !
- Else if space
is a String , then- If the length of space ≤ 10, let gap be space;
otherwise let gap be the
substring of space from 0 to 10.
- If the length of space ≤ 10, let gap be space;
otherwise let gap be the
- Else,
- Let gap be the empty String.
- Let wrapper be
OrdinaryObjectCreate (%Object.prototype% ). - Perform !
CreateDataPropertyOrThrow (wrapper, the empty String, value). - Let state be the
JSON Serialization Record { [[ReplacerFunction]]: ReplacerFunction, [[Stack]]: stack, [[Indent]]: indent, [[Gap]]: gap, [[PropertyList]]: PropertyList }. - Return ?
SerializeJSONProperty (state, the empty String, wrapper).
The
JSON structures are allowed to be nested to any depth, but they must be acyclic. If
value is or contains a cyclic structure, then this function must throw a
a = [];
a[0] = a;
my_text = JSON.stringify(a); // This must throw a TypeError.Symbolic primitive values are rendered as follows:
-
The
null value is rendered in JSON text as the String value"null" . -
The
undefined value is not rendered. -
The
true value is rendered in JSON text as the String value"true" . -
The
false value is rendered in JSON text as the String value"false" .
String values are wrapped in QUOTATION MARK (") code units. The code units
" and \ are escaped with \ prefixes. Control
characters code units are replaced with escape sequences \uHHHH, or with
the shorter forms, \b (BACKSPACE), \f (FORM FEED),
\n (LINE FEED), \r (CARRIAGE RETURN), \t
(CHARACTER TABULATION).
Values that do not have a JSON representation (such as
An object is rendered as U+007B (LEFT CURLY BRACKET) followed by zero or more properties,
separated with a U+002C (COMMA), closed with a U+007D (RIGHT CURLY BRACKET). A property
is a quoted String representing the
25.5.2.1 JSON Serialization Record
A JSON Serialization Record is
a
JSON Serialization Records have the fields listed in
| Field Name | Value | Meaning |
|---|---|---|
| [[ReplacerFunction]] | a |
A function that can supply replacement values for object properties (from JSON.stringify's replacer parameter). |
| [[PropertyList]] | either a |
The names of properties to include when serializing a non-array object (from JSON.stringify's replacer parameter). |
| [[Gap]] | a String | The unit of indentation (from JSON.stringify's space parameter). |
| [[Stack]] | a |
The set of nested objects that are in the process of being serialized. Used to detect cyclic structures. |
| [[Indent]] | a String | The current indentation. |
25.5.2.2 SerializeJSONProperty ( state, key, holder )
The abstract operation SerializeJSONProperty takes arguments state (a
- Let value be ?
Get (holder, key). - If value
is an Object or valueis a BigInt , then- Let toJSON be ?
GetV (value,"toJSON" ). - If
IsCallable (toJSON) istrue , then- Set value to ?
Call (toJSON, value, « key »).
- Set value to ?
- Let toJSON be ?
- If state.[[ReplacerFunction]] is not
undefined , then- Set value to ?
Call (state.[[ReplacerFunction]], holder, « key, value »).
- Set value to ?
- If value
is an Object , then- If value has a [[NumberData]] internal
slot, then
- Set value to ?
ToNumber (value).
- Set value to ?
- Else if value has a [[StringData]]
internal slot, then
- Set value to ?
ToString (value).
- Set value to ?
- Else if value has a [[BooleanData]]
internal slot, then
- Set value to value.[[BooleanData]].
- Else if value has a [[BigIntData]]
internal slot, then
- Set value to value.[[BigIntData]].
- If value has a [[NumberData]] internal
slot, then
- If value is
null , return"null" . - If value is
true , return"true" . - If value is
false , return"false" . - If value
is a String , returnQuoteJSONString (value). - If value
is a Number , then - If value
is a BigInt , throw aTypeError exception. - If value
is an Object andIsCallable (value) isfalse , then- Let isArray be ?
IsArray (value). - If isArray is
true , return ?SerializeJSONArray (state, value). - Return ?
SerializeJSONObject (state, value).
- Let isArray be ?
- Return
undefined .
25.5.2.3 QuoteJSONString ( value )
The abstract operation QuoteJSONString takes argument value (a String) and returns
a String. It wraps value in 0x0022 (QUOTATION MARK) code units and escapes
certain other code units within it. This operation interprets value as a sequence
of UTF-16 encoded code points, as described in
- Let product be the String value consisting solely of the code unit 0x0022 (QUOTATION MARK).
- For each code point C of
StringToCodePoints (value), do- If C is listed in the “Code Point” column of
Table 81 , then- Set product to the
string-concatenation of product and the escape sequence for C as specified in the “Escape Sequence” column of the corresponding row.
- Set product to the
- Else if C has a numeric value less than 0x0020 (SPACE) or
C has the same numeric value as a
leading surrogate ortrailing surrogate , then- Let unit be the code unit whose numeric value is the numeric value of C.
- Set product to the
string-concatenation of product andUnicodeEscape (unit).
- Else,
- Set product to the
string-concatenation of product andUTF16EncodeCodePoint (C).
- Set product to the
- If C is listed in the “Code Point” column of
- Set product to the
string-concatenation of product and the code unit 0x0022 (QUOTATION MARK). - Return product.
| Code Point | Unicode Character Name | Escape Sequence |
|---|---|---|
| U+0008 | BACKSPACE |
\b
|
| U+0009 | CHARACTER TABULATION |
\t
|
| U+000A | LINE FEED (LF) |
\n
|
| U+000C | FORM FEED (FF) |
\f
|
| U+000D | CARRIAGE RETURN (CR) |
\r
|
| U+0022 | QUOTATION MARK |
\"
|
| U+005C | REVERSE SOLIDUS |
\\
|
25.5.2.4 UnicodeEscape ( C )
The abstract operation UnicodeEscape takes argument C (a code unit) and returns a String. It represents C as a Unicode escape sequence. It performs the following steps when called:
- Let n be the numeric value of C.
Assert : n ≤ 0xFFFF.- Let hex be the String representation of n, formatted as a lowercase hexadecimal number.
- Return the
string-concatenation of the code unit 0x005C (REVERSE SOLIDUS),"u" , andStringPad (hex, 4,"0" ,start ).
25.5.2.5 SerializeJSONObject ( state, value )
The abstract operation SerializeJSONObject takes arguments state (a
- If state.[[Stack]] contains value,
throw a
TypeError exception because the structure is cyclical. - Append value to state.[[Stack]].
- Let stepBack be state.[[Indent]].
- Set state.[[Indent]] to the
string-concatenation of state.[[Indent]] and state.[[Gap]]. - If state.[[PropertyList]] is not
undefined , then- Let K be state.[[PropertyList]].
- Else,
- Let K be ?
EnumerableOwnProperties (value,key ).
- Let K be ?
- Let partial be a new empty
List . - For each element P of K, do
- Let strP be ?
SerializeJSONProperty (state, P, value). - If strP is not
undefined , then- Let member be
QuoteJSONString (P). - Set member to the
string-concatenation of member and":" . - If state.[[Gap]] is not the
empty String, then
- Set member to the
string-concatenation of member and the code unit 0x0020 (SPACE).
- Set member to the
- Set member to the
string-concatenation of member and strP. - Append member to partial.
- Let member be
- Let strP be ?
- If partial is empty, then
- Let final be
"{}" .
- Let final be
- Else,
- If state.[[Gap]] is the empty String,
then
- Let properties be the String value formed by concatenating all the element Strings of partial with each adjacent pair of Strings separated with the code unit 0x002C (COMMA). A comma is not inserted either before the first String or after the last String.
- Let final be the
string-concatenation of"{" , properties, and"}" .
- Else,
- Let separator be the
string-concatenation of the code unit 0x002C (COMMA), the code unit 0x000A (LINE FEED), and state.[[Indent]]. - Let properties be the String value formed by concatenating all the element Strings of partial with each adjacent pair of Strings separated with separator. The separator String is not inserted either before the first String or after the last String.
- Let final be the
string-concatenation of"{" , the code unit 0x000A (LINE FEED), state.[[Indent]], properties, the code unit 0x000A (LINE FEED), stepBack, and"}" .
- Let separator be the
- If state.[[Gap]] is the empty String,
then
- Remove the last element of state.[[Stack]].
- Set state.[[Indent]] to stepBack.
- Return final.
25.5.2.6 SerializeJSONArray ( state, value )
The abstract operation SerializeJSONArray takes arguments state (a
- If state.[[Stack]] contains value,
throw a
TypeError exception because the structure is cyclical. - Append value to state.[[Stack]].
- Let stepBack be state.[[Indent]].
- Set state.[[Indent]] to the
string-concatenation of state.[[Indent]] and state.[[Gap]]. - Let partial be a new empty
List . - Let len be ?
LengthOfArrayLike (value). - Let index be 0.
- Repeat, while index < len,
- Let strP be ?
SerializeJSONProperty (state, !ToString (𝔽 (index)), value). - If strP is
undefined , then- Append
"null" to partial.
- Append
- Else,
- Append strP to partial.
- Set index to index + 1.
- Let strP be ?
- If partial is empty, then
- Let final be
"[]" .
- Let final be
- Else,
- If state.[[Gap]] is the empty String,
then
- Let properties be the String value formed by concatenating all the element Strings of partial with each adjacent pair of Strings separated with the code unit 0x002C (COMMA). A comma is not inserted either before the first String or after the last String.
- Let final be the
string-concatenation of"[" , properties, and"]" .
- Else,
- Let separator be the
string-concatenation of the code unit 0x002C (COMMA), the code unit 0x000A (LINE FEED), and state.[[Indent]]. - Let properties be the String value formed by concatenating all the element Strings of partial with each adjacent pair of Strings separated with separator. The separator String is not inserted either before the first String or after the last String.
- Let final be the
string-concatenation of"[" , the code unit 0x000A (LINE FEED), state.[[Indent]], properties, the code unit 0x000A (LINE FEED), stepBack, and"]" .
- Let separator be the
- If state.[[Gap]] is the empty String,
then
- Remove the last element of state.[[Stack]].
- Set state.[[Indent]] to stepBack.
- Return final.
The representation of arrays includes only the elements in the array.length
(exclusive). Properties whose keys are not
25.5.3 JSON [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
26 Managing Memory
26.1 WeakRef Objects
A
26.1.1 The WeakRef Constructor
The WeakRef
- is %WeakRef%.
-
is the initial value of the
"WeakRef" property of theglobal object . -
creates and initializes a new WeakRef when called as a
constructor . - is not intended to be called as a function and will throw an exception when called in that manner.
-
may be used as the value in an
extendsclause of a class definition. Subclassconstructors that intend to inherit the specifiedWeakRefbehaviour must include asupercall to theWeakRefconstructor to create and initialize the subclass instance with the internal state necessary to support theWeakRef.prototypebuilt-in methods.
26.1.1.1 WeakRef ( target )
This function performs the following steps when called:
- If NewTarget is
undefined , throw aTypeError exception. - If
CanBeHeldWeakly (target) isfalse , throw aTypeError exception. - Let weakRef be ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakRef.prototype%" , « [[WeakRefTarget]] »). - Perform
AddToKeptObjects (target). - Set weakRef.[[WeakRefTarget]] to target.
- Return weakRef.
26.1.2 Properties of the WeakRef Constructor
The
-
has a [[Prototype]] internal slot whose value is
%Function.prototype% . - has the following properties:
26.1.2.1 WeakRef.prototype
The initial value of WeakRef.prototype is the
This property has the attributes { [[Writable]]:
26.1.3 Properties of the WeakRef Prototype Object
The WeakRef prototype object:
- is %WeakRef.prototype%.
-
has a [[Prototype]] internal slot whose value is
%Object.prototype% . - is an
ordinary object . - does not have a [[WeakRefTarget]] internal slot.
26.1.3.1 WeakRef.prototype.constructor
The initial value of WeakRef.prototype.constructor is
This property has the attributes { [[Writable]]:
26.1.3.2 WeakRef.prototype.deref ( )
This method performs the following steps when called:
- Let weakRef be the
this value. - Perform ?
RequireInternalSlot (weakRef, [[WeakRefTarget]]). - Return
WeakRefDeref (weakRef).
If the
let target = { foo() {} };
let weakRef = new WeakRef(target);
// ... later ...
if (weakRef.deref()) {
weakRef.deref().foo();
}In the above example, if the first deref does not evaluate to
26.1.3.3 WeakRef.prototype [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
26.1.4 WeakRef Abstract Operations
26.1.4.1 WeakRefDeref ( weakRef )
The abstract operation WeakRefDeref takes argument weakRef (a
- Let target be weakRef.[[WeakRefTarget]].
- If target is not
empty , then- Perform
AddToKeptObjects (target). - Return target.
- Perform
- Return
undefined .
This abstract operation is defined separately from WeakRef.prototype.deref strictly to make it possible to succinctly define liveness.
26.1.5 Properties of WeakRef Instances
26.2 FinalizationRegistry Objects
A
26.2.1 The FinalizationRegistry Constructor
The FinalizationRegistry
- is %FinalizationRegistry%.
-
is the initial value of the
"FinalizationRegistry" property of theglobal object . -
creates and initializes a new FinalizationRegistry when called as a
constructor . - is not intended to be called as a function and will throw an exception when called in that manner.
-
may be used as the value in an
extendsclause of a class definition. Subclassconstructors that intend to inherit the specifiedFinalizationRegistrybehaviour must include asupercall to theFinalizationRegistryconstructor to create and initialize the subclass instance with the internal state necessary to support theFinalizationRegistry.prototypebuilt-in methods.
26.2.1.1 FinalizationRegistry ( cleanupCallback )
This function performs the following steps when called:
- If NewTarget is
undefined , throw aTypeError exception. - If
IsCallable (cleanupCallback) isfalse , throw aTypeError exception. - Let finalizationRegistry be ?
OrdinaryCreateFromConstructor (NewTarget,"%FinalizationRegistry.prototype%" , « [[Realm]], [[CleanupCallback]], [[Cells]] »). - Let fn be the
active function object . - Set finalizationRegistry.[[Realm]] to fn.[[Realm]].
- Set finalizationRegistry.[[CleanupCallback]] to
HostMakeJobCallback (cleanupCallback). - Set finalizationRegistry.[[Cells]] to a new
empty
List . - Return finalizationRegistry.
26.2.2 Properties of the FinalizationRegistry Constructor
The
-
has a [[Prototype]] internal slot whose value is
%Function.prototype% . - has the following properties:
26.2.2.1 FinalizationRegistry.prototype
The initial value of FinalizationRegistry.prototype is the
This property has the attributes { [[Writable]]:
26.2.3 Properties of the FinalizationRegistry Prototype Object
The FinalizationRegistry prototype object:
- is %FinalizationRegistry.prototype%.
-
has a [[Prototype]] internal slot whose value is
%Object.prototype% . - is an
ordinary object . - does not have [[Cells]] and [[CleanupCallback]] internal slots.
26.2.3.1 FinalizationRegistry.prototype.constructor
The initial value of FinalizationRegistry.prototype.constructor is
26.2.3.2 FinalizationRegistry.prototype.register ( target, heldValue [ , unregisterToken ] )
This method performs the following steps when called:
- Let finalizationRegistry be the
this value. - Perform ?
RequireInternalSlot (finalizationRegistry, [[Cells]]). - If
CanBeHeldWeakly (target) isfalse , throw aTypeError exception. - If
SameValue (target, heldValue) istrue , throw aTypeError exception. - If
CanBeHeldWeakly (unregisterToken) isfalse , then- If unregisterToken is not
undefined , throw aTypeError exception. - Set unregisterToken to
empty .
- If unregisterToken is not
- Let cell be the
Record { [[WeakRefTarget]]: target, [[HeldValue]]: heldValue, [[UnregisterToken]]: unregisterToken }. - Append cell to finalizationRegistry.[[Cells]].
- Return
undefined .
Based on the algorithms and definitions in this specification, cell.[[HeldValue]] is
26.2.3.3 FinalizationRegistry.prototype.unregister ( unregisterToken )
This method performs the following steps when called:
- Let finalizationRegistry be the
this value. - Perform ?
RequireInternalSlot (finalizationRegistry, [[Cells]]). - If
CanBeHeldWeakly (unregisterToken) isfalse , throw aTypeError exception. - Let removed be
false . - For each
Record { [[WeakRefTarget]], [[HeldValue]], [[UnregisterToken]] } cell of finalizationRegistry.[[Cells]], do- If cell.[[UnregisterToken]] is not
empty andSameValue (cell.[[UnregisterToken]], unregisterToken) istrue , then- Remove cell from finalizationRegistry.[[Cells]].
- Set removed to
true .
- If cell.[[UnregisterToken]] is not
- Return removed.
26.2.3.4 FinalizationRegistry.prototype [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
26.2.4 Properties of FinalizationRegistry Instances
27 Control Abstraction Objects
27.1 Iteration
27.1.1 Common Iteration Interfaces
An interface is a set of
27.1.1.1 The Iterable Interface
The iterable interface includes the property described in
| Property | Value | Requirements |
|---|---|---|
%Symbol.iterator%
|
a function that returns an |
The returned object must conform to the |
27.1.1.2 The Iterator Interface
An object that implements the iterator
interface must include the property in
| Property | Value | Requirements |
|---|---|---|
|
|
a function that returns an |
The returned object must conform to the next method of an next method of that object should also return an |
Arguments may be passed to the next function but their interpretation
and validity is dependent upon the target iterator. The for-of statement and other
common users of iterators do not pass any arguments, so iterator objects that expect
to be used in such a manner must be prepared to deal with being called with no
arguments.
| Property | Value | Requirements |
|---|---|---|
|
|
a function that returns an |
The returned object must conform to the next
method calls to the return method.
However, this requirement is not enforced.
|
|
|
a function that returns an |
The returned object must conform to the throw the value passed as
the argument. If the method does not throw, the returned
|
Typically callers of these methods should check for their existence before invoking
them. Certain ECMAScript language features including
for-of, yield*, and array destructuring call
these methods after performing an existence check. Most ECMAScript library functions
that accept
27.1.1.3 The Async Iterable Interface
The async iterable interface includes the properties described in
| Property | Value | Requirements |
|---|---|---|
%Symbol.asyncIterator% |
a function that returns an |
The returned object must conform to the |
27.1.1.4 The Async Iterator Interface
An object that implements the async iterator interface must include the properties in
| Property | Value | Requirements |
|---|---|---|
| a function that returns a promise for an |
The returned promise, when fulfilled, must fulfill with an object
that conforms to the Additionally, the |
Arguments may be passed to the next function but their interpretation
and validity is dependent upon the target async iterator. The
for-await-of statement and other common users
of async iterators do not pass any arguments, so async iterator objects that expect
to be used in such a manner must be prepared to deal with being called with no
arguments.
| Property | Value | Requirements |
|---|---|---|
| a function that returns a promise for an |
The returned promise, when fulfilled, must fulfill with an object
that conforms to the Additionally, the |
|
| a function that returns a promise for an |
The returned promise, when fulfilled, must fulfill with an object
that conforms to the If the returned promise is fulfilled, the |
Typically callers of these methods should check for their existence before invoking
them. Certain ECMAScript language features including
for-await-of and yield* call
these methods after performing an existence check.
27.1.1.5 The IteratorResult Interface
The IteratorResult
interface includes the properties listed in
| Property | Value | Requirements |
|---|---|---|
|
|
a Boolean |
This is the result status of an next method call. If the end of the |
|
|
an |
If done is |
27.1.2 Iterator Helper Objects
An Iterator Helper object is an
27.1.2.1 The %IteratorHelperPrototype% Object
The %IteratorHelperPrototype% object:
- has properties that are inherited by all
Iterator Helper objects . - is an
ordinary object . - has a [[Prototype]] internal slot whose value is
%Iterator.prototype% . - has the following properties:
27.1.2.1.1 %IteratorHelperPrototype%.next ( )
- Return ?
GeneratorResume (this value,undefined ,"Iterator Helper" ).
27.1.2.1.2 %IteratorHelperPrototype%.return ( )
- Let O be
this value. - Perform ?
RequireInternalSlot (O, [[UnderlyingIterator]]). Assert : O has a [[GeneratorState]] internal slot.- If O.[[GeneratorState]] is
suspended-start , then- Set O.[[GeneratorState]] to
completed . - NOTE: Once a generator enters the completed state it never leaves it and
its associated
execution context is never resumed. Any execution state associated with O can be discarded at this point. - Perform ?
IteratorClose (O.[[UnderlyingIterator]],NormalCompletion (unused )). - Return
CreateIteratorResultObject (undefined ,true ).
- Set O.[[GeneratorState]] to
- Let C be
ReturnCompletion (undefined ). - Return ?
GeneratorResumeAbrupt (O, C,"Iterator Helper" ).
27.1.2.1.3 %IteratorHelperPrototype% [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
27.1.3 Iterator Objects
27.1.3.1 The Iterator Constructor
The Iterator
- is %Iterator%.
- is the initial value of the
"Iterator" property of theglobal object . - is designed to be subclassable. It may be used as the value of an
extends clause of a class definition.
27.1.3.1.1 Iterator ( )
This function performs the following steps when called:
- If NewTarget is either
undefined or theactive function object , throw aTypeError exception. - Return ?
OrdinaryCreateFromConstructor (NewTarget,"%Iterator.prototype%" ).
27.1.3.2 Properties of the Iterator Constructor
The
- has a [[Prototype]] internal slot whose value is
%Function.prototype% . - has the following properties:
27.1.3.2.1 Iterator.from ( O )
- Let iteratorRecord be ?
GetIteratorFlattenable (O,iterate-string-primitives ). - Let hasInstance be ?
OrdinaryHasInstance (%Iterator% , iteratorRecord.[[Iterator]]). - If hasInstance is
true , then- Return iteratorRecord.[[Iterator]].
- Let wrapper be
OrdinaryObjectCreate (%WrapForValidIteratorPrototype% , « [[Iterated]] »). - Set wrapper.[[Iterated]] to iteratorRecord.
- Return wrapper.
27.1.3.2.1.1 The %WrapForValidIteratorPrototype% Object
The %WrapForValidIteratorPrototype% object:
- is an
ordinary object . - has a [[Prototype]] internal slot whose value is
%Iterator.prototype% .
27.1.3.2.1.1.1 %WrapForValidIteratorPrototype%.next ( )
- Let O be
this value. - Perform ?
RequireInternalSlot (O, [[Iterated]]). - Let iteratorRecord be O.[[Iterated]].
- Return ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]]).
27.1.3.2.1.1.2 %WrapForValidIteratorPrototype%.return ( )
- Let O be
this value. - Perform ?
RequireInternalSlot (O, [[Iterated]]). - Let iterator be O.[[Iterated]].[[Iterator]].
Assert : iteratoris an Object .- Let returnMethod be ?
GetMethod (iterator,"return" ). - If returnMethod is
undefined , then- Return
CreateIteratorResultObject (undefined ,true ).
- Return
- Return ?
Call (returnMethod, iterator).
27.1.3.2.2 Iterator.prototype
The initial value of Iterator.prototype is the
This property has the attributes { [[Writable]]:
27.1.4 Properties of the Iterator Prototype Object
The Iterator prototype object:
- is %Iterator.prototype%.
- has a [[Prototype]] internal slot whose value is
%Object.prototype% . - is an
ordinary object .
All objects defined in this specification that implement the
The following expression is one way that ECMAScript code can access the %Iterator.prototype% object:
Object.getPrototypeOf(Object.getPrototypeOf([][Symbol.iterator]()))27.1.4.1 Iterator.prototype.constructor
Iterator.prototype.constructor is an
27.1.4.1.1 get Iterator.prototype.constructor
The value of the [[Get]] attribute is a built-in function that requires no arguments. It performs the following steps when called:
- Return
%Iterator% .
27.1.4.1.2 set Iterator.prototype.constructor
The value of the [[Set]] attribute is a built-in function that takes an argument v. It performs the following steps when called:
- Perform ?
SetterThatIgnoresPrototypeProperties (this value,%Iterator.prototype% ,"constructor" , v). - Return
undefined .
Unlike the
27.1.4.2 Iterator.prototype.drop ( limit )
This method performs the following steps when called:
- Let O be the
this value. - If O
is not an Object , throw aTypeError exception. - Let iterated be the
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }. - Let numLimit be
Completion (ToNumber (limit)). IfAbruptCloseIterator (numLimit, iterated).- If numLimit is
NaN , then- Let error be
ThrowCompletion (a newly createdRangeError object). - Return ?
IteratorClose (iterated, error).
- Let error be
- Let integerLimit be !
ToIntegerOrInfinity (numLimit). - If integerLimit < 0, then
- Let error be
ThrowCompletion (a newly createdRangeError object). - Return ?
IteratorClose (iterated, error).
- Let error be
- Set iterated to ?
GetIteratorDirect (O). - Let closure be a new
Abstract Closure with no parameters that captures iterated and integerLimit and performs the following steps when called:- Let remaining be integerLimit.
- Repeat, while remaining > 0,
- If remaining ≠ +∞, then
- Set remaining to remaining - 1.
- Let next be ?
IteratorStep (iterated). - If next is
done , returnReturnCompletion (undefined ).
- If remaining ≠ +∞, then
- Repeat,
- Let value be ?
IteratorStepValue (iterated). - If value is
done , returnReturnCompletion (undefined ). - Let completion be
Completion (Yield (value)). IfAbruptCloseIterator (completion, iterated).
- Let value be ?
- Let result be
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterator]] »). - Set result.[[UnderlyingIterator]] to iterated.
- Return result.
27.1.4.3 Iterator.prototype.every ( predicate )
This method performs the following steps when called:
- Let O be the
this value. - If O
is not an Object , throw aTypeError exception. - Let iterated be the
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }. - If
IsCallable (predicate) isfalse , then- Let error be
ThrowCompletion (a newly createdTypeError object). - Return ?
IteratorClose (iterated, error).
- Let error be
- Set iterated to ?
GetIteratorDirect (O). - Let counter be 0.
- Repeat,
- Let value be ?
IteratorStepValue (iterated). - If value is
done , returntrue . - Let result be
Completion (Call (predicate,undefined , « value,𝔽 (counter) »)). IfAbruptCloseIterator (result, iterated).- If
ToBoolean (result) isfalse , return ?IteratorClose (iterated,NormalCompletion (false )). - Set counter to counter + 1.
- Let value be ?
27.1.4.4 Iterator.prototype.filter ( predicate )
This method performs the following steps when called:
- Let O be the
this value. - If O
is not an Object , throw aTypeError exception. - Let iterated be the
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }. - If
IsCallable (predicate) isfalse , then- Let error be
ThrowCompletion (a newly createdTypeError object). - Return ?
IteratorClose (iterated, error).
- Let error be
- Set iterated to ?
GetIteratorDirect (O). - Let closure be a new
Abstract Closure with no parameters that captures iterated and predicate and performs the following steps when called:- Let counter be 0.
- Repeat,
- Let value be ?
IteratorStepValue (iterated). - If value is
done , returnReturnCompletion (undefined ). - Let selected be
Completion (Call (predicate,undefined , « value,𝔽 (counter) »)). IfAbruptCloseIterator (selected, iterated).- If
ToBoolean (selected) istrue , then- Let completion be
Completion (Yield (value)). IfAbruptCloseIterator (completion, iterated).
- Let completion be
- Set counter to counter + 1.
- Let value be ?
- Let result be
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterator]] »). - Set result.[[UnderlyingIterator]] to iterated.
- Return result.
27.1.4.5 Iterator.prototype.find ( predicate )
This method performs the following steps when called:
- Let O be the
this value. - If O
is not an Object , throw aTypeError exception. - Let iterated be the
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }. - If
IsCallable (predicate) isfalse , then- Let error be
ThrowCompletion (a newly createdTypeError object). - Return ?
IteratorClose (iterated, error).
- Let error be
- Set iterated to ?
GetIteratorDirect (O). - Let counter be 0.
- Repeat,
- Let value be ?
IteratorStepValue (iterated). - If value is
done , returnundefined . - Let result be
Completion (Call (predicate,undefined , « value,𝔽 (counter) »)). IfAbruptCloseIterator (result, iterated).- If
ToBoolean (result) istrue , return ?IteratorClose (iterated,NormalCompletion (value)). - Set counter to counter + 1.
- Let value be ?
27.1.4.6 Iterator.prototype.flatMap ( mapper )
This method performs the following steps when called:
- Let O be the
this value. - If O
is not an Object , throw aTypeError exception. - Let iterated be the
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }. - If
IsCallable (mapper) isfalse , then- Let error be
ThrowCompletion (a newly createdTypeError object). - Return ?
IteratorClose (iterated, error).
- Let error be
- Set iterated to ?
GetIteratorDirect (O). - Let closure be a new
Abstract Closure with no parameters that captures iterated and mapper and performs the following steps when called:- Let counter be 0.
- Repeat,
- Let value be ?
IteratorStepValue (iterated). - If value is
done , returnReturnCompletion (undefined ). - Let mapped be
Completion (Call (mapper,undefined , « value,𝔽 (counter) »)). IfAbruptCloseIterator (mapped, iterated).- Let innerIterator be
Completion (GetIteratorFlattenable (mapped,reject-primitives )). IfAbruptCloseIterator (innerIterator, iterated).- Let innerAlive be
true . - Repeat, while innerAlive is
true ,- Let innerValue be
Completion (IteratorStepValue (innerIterator)). IfAbruptCloseIterator (innerValue, iterated).- If innerValue is
done , then- Set innerAlive to
false .
- Set innerAlive to
- Else,
- Let completion be
Completion (Yield (innerValue)). - If completion is an
abrupt completion , then- Let backupCompletion be
Completion (IteratorClose (innerIterator, completion)). IfAbruptCloseIterator (backupCompletion, iterated).- Return ?
IteratorClose (iterated, completion).
- Let backupCompletion be
- Let completion be
- Let innerValue be
- Set counter to counter + 1.
- Let value be ?
- Let result be
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterator]] »). - Set result.[[UnderlyingIterator]] to iterated.
- Return result.
27.1.4.7 Iterator.prototype.forEach ( procedure )
This method performs the following steps when called:
- Let O be the
this value. - If O
is not an Object , throw aTypeError exception. - Let iterated be the
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }. - If
IsCallable (procedure) isfalse , then- Let error be
ThrowCompletion (a newly createdTypeError object). - Return ?
IteratorClose (iterated, error).
- Let error be
- Set iterated to ?
GetIteratorDirect (O). - Let counter be 0.
- Repeat,
- Let value be ?
IteratorStepValue (iterated). - If value is
done , returnundefined . - Let result be
Completion (Call (procedure,undefined , « value,𝔽 (counter) »)). IfAbruptCloseIterator (result, iterated).- Set counter to counter + 1.
- Let value be ?
27.1.4.8 Iterator.prototype.map ( mapper )
This method performs the following steps when called:
- Let O be the
this value. - If O
is not an Object , throw aTypeError exception. - Let iterated be the
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }. - If
IsCallable (mapper) isfalse , then- Let error be
ThrowCompletion (a newly createdTypeError object). - Return ?
IteratorClose (iterated, error).
- Let error be
- Set iterated to ?
GetIteratorDirect (O). - Let closure be a new
Abstract Closure with no parameters that captures iterated and mapper and performs the following steps when called:- Let counter be 0.
- Repeat,
- Let value be ?
IteratorStepValue (iterated). - If value is
done , returnReturnCompletion (undefined ). - Let mapped be
Completion (Call (mapper,undefined , « value,𝔽 (counter) »)). IfAbruptCloseIterator (mapped, iterated).- Let completion be
Completion (Yield (mapped)). IfAbruptCloseIterator (completion, iterated).- Set counter to counter + 1.
- Let value be ?
- Let result be
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterator]] »). - Set result.[[UnderlyingIterator]] to iterated.
- Return result.
27.1.4.9 Iterator.prototype.reduce ( reducer [ , initialValue ] )
This method performs the following steps when called:
- Let O be the
this value. - If O
is not an Object , throw aTypeError exception. - Let iterated be the
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }. - If
IsCallable (reducer) isfalse , then- Let error be
ThrowCompletion (a newly createdTypeError object). - Return ?
IteratorClose (iterated, error).
- Let error be
- Set iterated to ?
GetIteratorDirect (O). - If initialValue is not present, then
- Let accumulator be ?
IteratorStepValue (iterated). - If accumulator is
done , throw aTypeError exception. - Let counter be 1.
- Let accumulator be ?
- Else,
- Let accumulator be initialValue.
- Let counter be 0.
- Repeat,
- Let value be ?
IteratorStepValue (iterated). - If value is
done , return accumulator. - Let result be
Completion (Call (reducer,undefined , « accumulator, value,𝔽 (counter) »)). IfAbruptCloseIterator (result, iterated).- Set accumulator to result.
- Set counter to counter + 1.
- Let value be ?
27.1.4.10 Iterator.prototype.some ( predicate )
This method performs the following steps when called:
- Let O be the
this value. - If O
is not an Object , throw aTypeError exception. - Let iterated be the
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }. - If
IsCallable (predicate) isfalse , then- Let error be
ThrowCompletion (a newly createdTypeError object). - Return ?
IteratorClose (iterated, error).
- Let error be
- Set iterated to ?
GetIteratorDirect (O). - Let counter be 0.
- Repeat,
- Let value be ?
IteratorStepValue (iterated). - If value is
done , returnfalse . - Let result be
Completion (Call (predicate,undefined , « value,𝔽 (counter) »)). IfAbruptCloseIterator (result, iterated).- If
ToBoolean (result) istrue , return ?IteratorClose (iterated,NormalCompletion (true )). - Set counter to counter + 1.
- Let value be ?
27.1.4.11 Iterator.prototype.take ( limit )
This method performs the following steps when called:
- Let O be the
this value. - If O
is not an Object , throw aTypeError exception. - Let iterated be the
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }. - Let numLimit be
Completion (ToNumber (limit)). IfAbruptCloseIterator (numLimit, iterated).- If numLimit is
NaN , then- Let error be
ThrowCompletion (a newly createdRangeError object). - Return ?
IteratorClose (iterated, error).
- Let error be
- Let integerLimit be !
ToIntegerOrInfinity (numLimit). - If integerLimit < 0, then
- Let error be
ThrowCompletion (a newly createdRangeError object). - Return ?
IteratorClose (iterated, error).
- Let error be
- Set iterated to ?
GetIteratorDirect (O). - Let closure be a new
Abstract Closure with no parameters that captures iterated and integerLimit and performs the following steps when called:- Let remaining be integerLimit.
- Repeat,
- If remaining = 0, then
- Return ?
IteratorClose (iterated,ReturnCompletion (undefined )).
- Return ?
- If remaining ≠ +∞, then
- Set remaining to remaining - 1.
- Let value be ?
IteratorStepValue (iterated). - If value is
done , returnReturnCompletion (undefined ). - Let completion be
Completion (Yield (value)). IfAbruptCloseIterator (completion, iterated).
- If remaining = 0, then
- Let result be
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterator]] »). - Set result.[[UnderlyingIterator]] to iterated.
- Return result.
27.1.4.12 Iterator.prototype.toArray ( )
This method performs the following steps when called:
- Let O be the
this value. - If O
is not an Object , throw aTypeError exception. - Let iterated be ?
GetIteratorDirect (O). - Let items be a new empty
List . - Repeat,
- Let value be ?
IteratorStepValue (iterated). - If value is
done , returnCreateArrayFromList (items). - Append value to items.
- Let value be ?
27.1.4.13 Iterator.prototype [ %Symbol.iterator% ] ( )
This function performs the following steps when called:
- Return the
this value.
The value of the
27.1.4.14 Iterator.prototype [ %Symbol.toStringTag% ]
Iterator.prototype[%Symbol.toStringTag%] is an
27.1.4.14.1 get Iterator.prototype [ %Symbol.toStringTag% ]
The value of the [[Get]] attribute is a built-in function that requires no arguments. It performs the following steps when called:
- Return
"Iterator" .
27.1.4.14.2 set Iterator.prototype [ %Symbol.toStringTag% ]
The value of the [[Set]] attribute is a built-in function that takes an argument v. It performs the following steps when called:
- Perform ?
SetterThatIgnoresPrototypeProperties (this value,%Iterator.prototype% ,%Symbol.toStringTag% , v). - Return
undefined .
Unlike the
27.1.5 The %AsyncIteratorPrototype% Object
The %AsyncIteratorPrototype% object:
- has a [[Prototype]] internal slot whose value is
%Object.prototype% . - is an
ordinary object .
All objects defined in this specification that implement the
27.1.5.1 %AsyncIteratorPrototype% [ %Symbol.asyncIterator% ] ( )
This function performs the following steps when called:
- Return the
this value.
The value of the
27.1.6 Async-from-Sync Iterator Objects
An Async-from-Sync Iterator
object is an
27.1.6.1 CreateAsyncFromSyncIterator ( syncIteratorRecord )
The abstract operation CreateAsyncFromSyncIterator takes argument
syncIteratorRecord (an
- Let asyncIterator be
OrdinaryObjectCreate (%AsyncFromSyncIteratorPrototype% , « [[SyncIteratorRecord]] »). - Set asyncIterator.[[SyncIteratorRecord]] to syncIteratorRecord.
- Let nextMethod be !
Get (asyncIterator,"next" ). - Let iteratorRecord be the
Iterator Record { [[Iterator]]: asyncIterator, [[NextMethod]]: nextMethod, [[Done]]:false }. - Return iteratorRecord.
27.1.6.2 The %AsyncFromSyncIteratorPrototype% Object
The %AsyncFromSyncIteratorPrototype% object:
- has properties that are inherited by all
Async-from-Sync Iterator objects . - is an
ordinary object . - has a [[Prototype]] internal slot whose value is
%AsyncIteratorPrototype% . - is never directly accessible to ECMAScript code.
- has the following properties:
27.1.6.2.1 %AsyncFromSyncIteratorPrototype%.next ( [ value ] )
- Let O be the
this value. Assert : Ois an Object that has a [[SyncIteratorRecord]] internal slot.- Let promiseCapability be !
NewPromiseCapability (%Promise% ). - Let syncIteratorRecord be O.[[SyncIteratorRecord]].
- If value is present, then
- Let result be
Completion (IteratorNext (syncIteratorRecord, value)).
- Let result be
- Else,
- Let result be
Completion (IteratorNext (syncIteratorRecord)).
- Let result be
IfAbruptRejectPromise (result, promiseCapability).- Return
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,true ).
27.1.6.2.2 %AsyncFromSyncIteratorPrototype%.return ( [ value ] )
- Let O be the
this value. Assert : Ois an Object that has a [[SyncIteratorRecord]] internal slot.- Let promiseCapability be !
NewPromiseCapability (%Promise% ). - Let syncIteratorRecord be O.[[SyncIteratorRecord]].
- Let syncIterator be syncIteratorRecord.[[Iterator]].
- Let return be
Completion (GetMethod (syncIterator,"return" )). IfAbruptRejectPromise (return, promiseCapability).- If return is
undefined , then- Let iteratorResult be
CreateIteratorResultObject (value,true ). - Perform ! Call(promiseCapability.[[Resolve]],
undefined , « iteratorResult »). - Return promiseCapability.[[Promise]].
- Let iteratorResult be
- If value is present, then
- Let result be
Completion (Call (return, syncIterator, « value »)).
- Let result be
- Else,
- Let result be
Completion (Call (return, syncIterator)).
- Let result be
IfAbruptRejectPromise (result, promiseCapability).- If result
is not an Object , then- Perform !
Call (promiseCapability.[[Reject]],undefined , « a newly createdTypeError object »). - Return promiseCapability.[[Promise]].
- Perform !
- Return
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,false ).
27.1.6.2.3 %AsyncFromSyncIteratorPrototype%.throw ( [ value ] )
- Let O be the
this value. Assert : Ois an Object that has a [[SyncIteratorRecord]] internal slot.- Let promiseCapability be !
NewPromiseCapability (%Promise% ). - Let syncIteratorRecord be O.[[SyncIteratorRecord]].
- Let syncIterator be syncIteratorRecord.[[Iterator]].
- Let throw be
Completion (GetMethod (syncIterator,"throw" )). IfAbruptRejectPromise (throw, promiseCapability).- If throw is
undefined , then- NOTE: If syncIterator does not have a
throwmethod, close it to give it a chance to clean up before we reject the capability. - Let closeCompletion be
NormalCompletion (empty ). - Let result be
Completion (IteratorClose (syncIteratorRecord, closeCompletion)). IfAbruptRejectPromise (result, promiseCapability).- NOTE: The next step throws a
TypeError to indicate that there was a protocol violation: syncIterator does not have athrowmethod. - NOTE: If closing syncIterator does not throw then the result of that operation is ignored, even if it yields a rejected promise.
- Perform !
Call (promiseCapability.[[Reject]],undefined , « a newly createdTypeError object »). - Return promiseCapability.[[Promise]].
- NOTE: If syncIterator does not have a
- If value is present, then
- Let result be
Completion (Call (throw, syncIterator, « value »)).
- Let result be
- Else,
- Let result be
Completion (Call (throw, syncIterator)).
- Let result be
IfAbruptRejectPromise (result, promiseCapability).- If result
is not an Object , then- Perform !
Call (promiseCapability.[[Reject]],undefined , « a newly createdTypeError object »). - Return promiseCapability.[[Promise]].
- Perform !
- Return
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,true ).
27.1.6.3 Properties of Async-from-Sync Iterator Instances
Async-from-Sync
| Internal Slot | Type | Description |
|---|---|---|
| [[SyncIteratorRecord]] |
an |
Represents the original synchronous |
27.1.6.4 AsyncFromSyncIteratorContinuation ( result, promiseCapability, syncIteratorRecord, closeOnRejection )
The abstract operation AsyncFromSyncIteratorContinuation takes arguments result
(an Object), promiseCapability (a
- NOTE: Because promiseCapability is derived from the intrinsic
%Promise% , the calls to promiseCapability.[[Reject]] entailed by the useIfAbruptRejectPromise below are guaranteed not to throw. - Let done be
Completion (IteratorComplete (result)). IfAbruptRejectPromise (done, promiseCapability).- Let value be
Completion (IteratorValue (result)). IfAbruptRejectPromise (value, promiseCapability).- Let valueWrapper be
Completion (PromiseResolve (%Promise% , value)). - If valueWrapper is an
abrupt completion , done isfalse , and closeOnRejection istrue , then- Set valueWrapper to
Completion (IteratorClose (syncIteratorRecord, valueWrapper)).
- Set valueWrapper to
IfAbruptRejectPromise (valueWrapper, promiseCapability).- Let unwrap be a new
Abstract Closure with parameters (v) that captures done and performs the following steps when called:- Return
CreateIteratorResultObject (v, done).
- Return
- Let onFulfilled be
CreateBuiltinFunction (unwrap, 1,"" , « »). - NOTE: onFulfilled is used when processing the
"value" property of anIteratorResult object in order to wait for its value if it is a promise and re-package the result in a new "unwrapped"IteratorResult object . - If done is
true , or if closeOnRejection isfalse , then- Let onRejected be
undefined .
- Let onRejected be
- Else,
- Let closeIterator be a new
Abstract Closure with parameters (error) that captures syncIteratorRecord and performs the following steps when called:- Return ?
IteratorClose (syncIteratorRecord,ThrowCompletion (error)).
- Return ?
- Let onRejected be
CreateBuiltinFunction (closeIterator, 1,"" , « »). - NOTE: onRejected is used to close the
Iterator when the"value" property of anIteratorResult object it yields is a rejected promise.
- Let closeIterator be a new
- Perform
PerformPromiseThen (valueWrapper, onFulfilled, onRejected, promiseCapability). - Return promiseCapability.[[Promise]].
27.2 Promise Objects
A Promise is an object that is used as a placeholder for the eventual results of a deferred (and possibly asynchronous) computation.
Any Promise is in one of three mutually exclusive states: fulfilled, rejected, and pending:
-
A promise
pis fulfilled ifp.then(f, r)will immediately enqueue aJob to call the functionf. -
A promise
pis rejected ifp.then(f, r)will immediately enqueue aJob to call the functionr. - A promise is pending if it is neither fulfilled nor rejected.
A promise is said to be settled if it is not pending, i.e. if it is either fulfilled or rejected.
A promise is resolved if it is settled or if it has been “locked in” to match the state of another promise. Attempting to resolve or reject a resolved promise has no effect. A promise is unresolved if it is not resolved. An unresolved promise is always in the pending state. A resolved promise may be pending, fulfilled or rejected.
27.2.1 Promise Abstract Operations
27.2.1.1 PromiseCapability Records
A PromiseCapability Record is a
PromiseCapability Records have the fields listed in
| Field Name | Value | Meaning |
|---|---|---|
| [[Promise]] | an Object | An object that is usable as a promise. |
| [[Resolve]] |
a |
The function that is used to resolve the given promise. |
| [[Reject]] |
a |
The function that is used to reject the given promise. |
27.2.1.1.1 IfAbruptRejectPromise ( value, capability )
IfAbruptRejectPromise is a shorthand for a sequence of algorithm steps that use a
IfAbruptRejectPromise (value, capability).
means the same thing as:
Assert : value is aCompletion Record .- If value is an
abrupt completion , then- Perform ?
Call (capability.[[Reject]],undefined , « value.[[Value]] »). - Return capability.[[Promise]].
- Perform ?
- Else,
- Set value to ! value.
27.2.1.2 PromiseReaction Records
A PromiseReaction Record is a
PromiseReaction Records have the fields listed in
| Field Name | Value | Meaning |
|---|---|---|
| [[Capability]] |
a |
The capabilities of the promise for which this record provides a reaction handler. |
| [[Type]] |
|
The [[Type]] is used when [[Handler]] is |
| [[Handler]] |
a |
The function that should be applied to the incoming value, and whose
return value will govern what happens to the derived promise. If [[Handler]] is |
27.2.1.3 CreateResolvingFunctions ( promise )
The abstract operation CreateResolvingFunctions takes argument promise (a Promise)
and returns a
- Let alreadyResolved be the
Record { [[Value]]:false }. - Let stepsResolve be the algorithm steps defined in
Promise Resolve Functions . - Let lengthResolve be the number of non-optional parameters of the
function definition in
Promise Resolve Functions . - Let resolve be
CreateBuiltinFunction (stepsResolve, lengthResolve,"" , « [[Promise]], [[AlreadyResolved]] »). - Set resolve.[[Promise]] to promise.
- Set resolve.[[AlreadyResolved]] to alreadyResolved.
- Let stepsReject be the algorithm steps defined in
Promise Reject Functions . - Let lengthReject be the number of non-optional parameters of the function
definition in
Promise Reject Functions . - Let reject be
CreateBuiltinFunction (stepsReject, lengthReject,"" , « [[Promise]], [[AlreadyResolved]] »). - Set reject.[[Promise]] to promise.
- Set reject.[[AlreadyResolved]] to alreadyResolved.
- Return the
Record { [[Resolve]]: resolve, [[Reject]]: reject }.
27.2.1.3.1 Promise Reject Functions
A promise reject function is an anonymous built-in function that has [[Promise]] and [[AlreadyResolved]] internal slots.
When a promise reject function is called with argument reason, the following steps are taken:
- Let F be the
active function object . Assert : F has a [[Promise]] internal slot whose valueis an Object .- Let promise be F.[[Promise]].
- Let alreadyResolved be F.[[AlreadyResolved]].
- If alreadyResolved.[[Value]] is
true , returnundefined . - Set alreadyResolved.[[Value]] to
true . - Perform
RejectPromise (promise, reason). - Return
undefined .
The
27.2.1.3.2 Promise Resolve Functions
A promise resolve function is an anonymous built-in function that has [[Promise]] and [[AlreadyResolved]] internal slots.
When a promise resolve function is called with argument resolution, the following steps are taken:
- Let F be the
active function object . Assert : F has a [[Promise]] internal slot whose valueis an Object .- Let promise be F.[[Promise]].
- Let alreadyResolved be F.[[AlreadyResolved]].
- If alreadyResolved.[[Value]] is
true , returnundefined . - Set alreadyResolved.[[Value]] to
true . - If
SameValue (resolution, promise) istrue , then- Let selfResolutionError be a newly created
TypeError object. - Perform
RejectPromise (promise, selfResolutionError). - Return
undefined .
- Let selfResolutionError be a newly created
- If resolution
is not an Object , then- Perform
FulfillPromise (promise, resolution). - Return
undefined .
- Perform
- Let then be
Completion (Get (resolution,"then" )). - If then is an
abrupt completion , then- Perform
RejectPromise (promise, then.[[Value]]). - Return
undefined .
- Perform
- Let thenAction be then.[[Value]].
- If
IsCallable (thenAction) isfalse , then- Perform
FulfillPromise (promise, resolution). - Return
undefined .
- Perform
- Let thenJobCallback be
HostMakeJobCallback (thenAction). - Let job be
NewPromiseResolveThenableJob (promise, resolution, thenJobCallback). - Perform
HostEnqueuePromiseJob (job.[[Job]], job.[[Realm]]). - Return
undefined .
The
27.2.1.4 FulfillPromise ( promise, value )
The abstract operation FulfillPromise takes arguments promise (a Promise) and
value (an
Assert : The value of promise.[[PromiseState]] ispending .- Let reactions be promise.[[PromiseFulfillReactions]].
- Set promise.[[PromiseResult]] to value.
- Set promise.[[PromiseFulfillReactions]] to
undefined . - Set promise.[[PromiseRejectReactions]] to
undefined . - Set promise.[[PromiseState]] to
fulfilled . - Perform
TriggerPromiseReactions (reactions, value). - Return
unused .
27.2.1.5 NewPromiseCapability ( C )
The abstract operation NewPromiseCapability takes argument C (an resolve and reject functions. The promise plus the
resolve and reject functions are used to initialize a new
- If
IsConstructor (C) isfalse , throw aTypeError exception. - NOTE: C is assumed to be a
constructor function that supports the parameter conventions of the Promiseconstructor (see27.2.3.1 ). - Let resolvingFunctions be the
Record { [[Resolve]]:undefined , [[Reject]]:undefined }. - Let executorClosure be a new
Abstract Closure with parameters (resolve, reject) that captures resolvingFunctions and performs the following steps when called:- If resolvingFunctions.[[Resolve]] is not
undefined , throw aTypeError exception. - If resolvingFunctions.[[Reject]] is not
undefined , throw aTypeError exception. - Set resolvingFunctions.[[Resolve]] to resolve.
- Set resolvingFunctions.[[Reject]] to reject.
- Return
undefined .
- If resolvingFunctions.[[Resolve]] is not
- Let executor be
CreateBuiltinFunction (executorClosure, 2,"" , « »). - Let promise be ?
Construct (C, « executor »). - If
IsCallable (resolvingFunctions.[[Resolve]]) isfalse , throw aTypeError exception. - If
IsCallable (resolvingFunctions.[[Reject]]) isfalse , throw aTypeError exception. - Return the
PromiseCapability Record { [[Promise]]: promise, [[Resolve]]: resolvingFunctions.[[Resolve]], [[Reject]]: resolvingFunctions.[[Reject]] }.
This abstract operation supports Promise subclassing, as it is generic on any
27.2.1.6 IsPromise ( x )
The abstract operation IsPromise takes argument x (an
- If x
is not an Object , returnfalse . - If x does not have a [[PromiseState]] internal
slot, return
false . - Return
true .
27.2.1.7 RejectPromise ( promise, reason )
The abstract operation RejectPromise takes arguments promise (a Promise) and
reason (an
Assert : The value of promise.[[PromiseState]] ispending .- Let reactions be promise.[[PromiseRejectReactions]].
- Set promise.[[PromiseResult]] to reason.
- Set promise.[[PromiseFulfillReactions]] to
undefined . - Set promise.[[PromiseRejectReactions]] to
undefined . - Set promise.[[PromiseState]] to
rejected . - If promise.[[PromiseIsHandled]] is
false , performHostPromiseRejectionTracker (promise,"reject" ). - Perform
TriggerPromiseReactions (reactions, reason). - Return
unused .
27.2.1.8 TriggerPromiseReactions ( reactions, argument )
The abstract operation TriggerPromiseReactions takes arguments reactions (a
- For each element reaction of reactions, do
- Let job be
NewPromiseReactionJob (reaction, argument). - Perform
HostEnqueuePromiseJob (job.[[Job]], job.[[Realm]]).
- Let job be
- Return
unused .
27.2.1.9 HostPromiseRejectionTracker ( promise, operation )
The
The default implementation of HostPromiseRejectionTracker is to return
HostPromiseRejectionTracker is called in two scenarios:
- When a promise is rejected without any handlers, it is called with its
operation argument set to
"reject" . - When a handler is added to a rejected promise for the first time, it is called
with its operation argument set to
"handle" .
A typical implementation of HostPromiseRejectionTracker might try to notify developers of unhandled rejections, while also being careful to notify them if such previous notifications are later invalidated by new handlers being attached.
If operation is
27.2.2 Promise Jobs
27.2.2.1 NewPromiseReactionJob ( reaction, argument )
The abstract operation NewPromiseReactionJob takes arguments reaction (a
- Let job be a new
Job Abstract Closure with no parameters that captures reaction and argument and performs the following steps when called:- Let promiseCapability be reaction.[[Capability]].
- Let type be reaction.[[Type]].
- Let handler be reaction.[[Handler]].
- If handler is
empty , then- If type is
fulfill , then- Let handlerResult be
NormalCompletion (argument).
- Let handlerResult be
- Else,
Assert : type isreject .- Let handlerResult be
ThrowCompletion (argument).
- If type is
- Else,
- Let handlerResult be
Completion (HostCallJobCallback (handler,undefined , « argument »)).
- Let handlerResult be
- If promiseCapability is
undefined , thenAssert : handlerResult is not anabrupt completion .- Return
empty .
Assert : promiseCapability is aPromiseCapability Record .- If handlerResult is an
abrupt completion , then- Return ?
Call (promiseCapability.[[Reject]],undefined , « handlerResult.[[Value]] »).
- Return ?
- Else,
- Return ?
Call (promiseCapability.[[Resolve]],undefined , « handlerResult.[[Value]] »).
- Return ?
- Let handlerRealm be
null . - If reaction.[[Handler]] is not
empty , then- Let getHandlerRealmResult be
Completion (GetFunctionRealm (reaction.[[Handler]].[[Callback]])). - If getHandlerRealmResult is a
normal completion , set handlerRealm to getHandlerRealmResult.[[Value]]. - Else, set handlerRealm to
the current Realm Record . - NOTE: handlerRealm is never
null unless the handler isundefined . When the handler is a revoked Proxy and no ECMAScript code runs, handlerRealm is used to create error objects.
- Let getHandlerRealmResult be
- Return the
Record { [[Job]]: job, [[Realm]]: handlerRealm }.
27.2.2.2 NewPromiseResolveThenableJob ( promiseToResolve, thenable, then )
The abstract operation NewPromiseResolveThenableJob takes arguments
promiseToResolve (a Promise), thenable (an Object), and
then (a
- Let job be a new
Job Abstract Closure with no parameters that captures promiseToResolve, thenable, and then and performs the following steps when called:- Let resolvingFunctions be
CreateResolvingFunctions (promiseToResolve). - Let thenCallResult be
Completion (HostCallJobCallback (then, thenable, « resolvingFunctions.[[Resolve]], resolvingFunctions.[[Reject]] »)). - If thenCallResult is an
abrupt completion , then- Return ?
Call (resolvingFunctions.[[Reject]],undefined , « thenCallResult.[[Value]] »).
- Return ?
- Return ! thenCallResult.
- Let resolvingFunctions be
- Let getThenRealmResult be
Completion (GetFunctionRealm (then.[[Callback]])). - If getThenRealmResult is a
normal completion , let thenRealm be getThenRealmResult.[[Value]]. - Else, let thenRealm be
the current Realm Record . - NOTE: thenRealm is never
null . When then.[[Callback]] is a revoked Proxy and no code runs, thenRealm is used to create error objects. - Return the
Record { [[Job]]: job, [[Realm]]: thenRealm }.
27.2.3 The Promise Constructor
The Promise
- is %Promise%.
- is the initial value of the
"Promise" property of theglobal object . - creates and initializes a new Promise when called as a
constructor . - is not intended to be called as a function and will throw an exception when called in that manner.
- may be used as the value in an
extendsclause of a class definition. Subclassconstructors that intend to inherit the specified Promise behaviour must include asupercall to the Promiseconstructor to create and initialize the subclass instance with the internal state necessary to support thePromiseandPromise.prototypebuilt-in methods.
27.2.3.1 Promise ( executor )
This function performs the following steps when called:
- If NewTarget is
undefined , throw aTypeError exception. - If
IsCallable (executor) isfalse , throw aTypeError exception. - Let promise be ?
OrdinaryCreateFromConstructor (NewTarget,"%Promise.prototype%" , « [[PromiseState]], [[PromiseResult]], [[PromiseFulfillReactions]], [[PromiseRejectReactions]], [[PromiseIsHandled]] »). - Set promise.[[PromiseState]] to
pending . - Set promise.[[PromiseResult]] to
empty . - Set promise.[[PromiseFulfillReactions]] to a new
empty
List . - Set promise.[[PromiseRejectReactions]] to a new
empty
List . - Set promise.[[PromiseIsHandled]] to
false . - Let resolvingFunctions be
CreateResolvingFunctions (promise). - Let completion be
Completion (Call (executor,undefined , « resolvingFunctions.[[Resolve]], resolvingFunctions.[[Reject]] »)). - If completion is an
abrupt completion , then- Perform ?
Call (resolvingFunctions.[[Reject]],undefined , « completion.[[Value]] »).
- Perform ?
- Return promise.
The executor argument must be a
The resolve function that is passed to an executor function accepts a single argument. The executor code may eventually call the resolve function to indicate that it wishes to resolve the associated Promise. The argument passed to the resolve function represents the eventual value of the deferred action and can be either the actual fulfillment value or another promise which will provide the value if it is fulfilled.
The reject function that is passed to an executor function accepts a single argument. The executor code may eventually call the reject function to indicate that the associated Promise is rejected and will never be fulfilled. The argument passed to the reject function is used as the rejection value of the promise. Typically it will be an Error object.
The resolve and reject functions passed to an executor function by the
Promise
27.2.4 Properties of the Promise Constructor
The Promise
- has a [[Prototype]] internal slot whose value is
%Function.prototype% . - has the following properties:
27.2.4.1 Promise.all ( iterable )
This function returns a new promise which is fulfilled with an array of fulfillment values
for the passed promises, or rejects with the reason of the first passed promise that
rejects. It resolves all elements of the passed
- Let C be the
this value. - Let promiseCapability be ?
NewPromiseCapability (C). - Let promiseResolve be
Completion (GetPromiseResolve (C)). IfAbruptRejectPromise (promiseResolve, promiseCapability).- Let iteratorRecord be
Completion (GetIterator (iterable,sync )). IfAbruptRejectPromise (iteratorRecord, promiseCapability).- Let result be
Completion (PerformPromiseAll (iteratorRecord, C, promiseCapability, promiseResolve)). - If result is an
abrupt completion , then- If iteratorRecord.[[Done]] is
false , set result toCompletion (IteratorClose (iteratorRecord, result)). IfAbruptRejectPromise (result, promiseCapability).
- If iteratorRecord.[[Done]] is
- Return ! result.
This function requires its
27.2.4.1.1 GetPromiseResolve ( promiseConstructor )
The abstract operation GetPromiseResolve takes argument promiseConstructor (a
- Let promiseResolve be ?
Get (promiseConstructor,"resolve" ). - If
IsCallable (promiseResolve) isfalse , throw aTypeError exception. - Return promiseResolve.
27.2.4.1.2 PerformPromiseAll ( iteratorRecord, constructor, resultCapability, promiseResolve )
The abstract operation PerformPromiseAll takes arguments iteratorRecord (an
- Let values be a new empty
List . - Let remainingElementsCount be the
Record { [[Value]]: 1 }. - Let index be 0.
- Repeat,
- Let next be ?
IteratorStepValue (iteratorRecord). - If next is
done , then- Set remainingElementsCount.[[Value]] to remainingElementsCount.[[Value]] - 1.
- If remainingElementsCount.[[Value]] = 0, then
- Let valuesArray be
CreateArrayFromList (values). - Perform ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »).
- Let valuesArray be
- Return resultCapability.[[Promise]].
- Append
undefined to values. - Let nextPromise be ?
Call (promiseResolve, constructor, « next »). - Let steps be the algorithm steps defined in
Promise.allResolve Element Functions - Let length be the number of non-optional parameters of the
function definition in
Promise.allResolve Element Functions - Let onFulfilled be
CreateBuiltinFunction (steps, length,"" , « [[AlreadyCalled]], [[Index]], [[Values]], [[Capability]], [[RemainingElements]] »). - Set onFulfilled.[[AlreadyCalled]] to
false . - Set onFulfilled.[[Index]] to index.
- Set onFulfilled.[[Values]] to values.
- Set onFulfilled.[[Capability]] to resultCapability.
- Set onFulfilled.[[RemainingElements]] to remainingElementsCount.
- Set remainingElementsCount.[[Value]] to remainingElementsCount.[[Value]] + 1.
- Perform ?
Invoke (nextPromise,"then" , « onFulfilled, resultCapability.[[Reject]] »). - Set index to index + 1.
- Let next be ?
27.2.4.1.3 Promise.all Resolve Element
Functions
A Promise.all resolve element function is an anonymous built-in function
that is used to resolve a specific Promise.all element. Each
Promise.all resolve element function has [[Index]], [[Values]], [[Capability]], [[RemainingElements]],
and [[AlreadyCalled]] internal slots.
When a Promise.all resolve element function is called with argument
x, the following steps are taken:
- Let F be the
active function object . - If F.[[AlreadyCalled]] is
true , returnundefined . - Set F.[[AlreadyCalled]] to
true . - Let index be F.[[Index]].
- Let values be F.[[Values]].
- Let promiseCapability be F.[[Capability]].
- Let remainingElementsCount be F.[[RemainingElements]].
- Set values[index] to x.
- Set remainingElementsCount.[[Value]] to remainingElementsCount.[[Value]] - 1.
- If remainingElementsCount.[[Value]] = 0,
then
- Let valuesArray be
CreateArrayFromList (values). - Return ?
Call (promiseCapability.[[Resolve]],undefined , « valuesArray »).
- Let valuesArray be
- Return
undefined .
The Promise.all resolve element
function is
27.2.4.2 Promise.allSettled ( iterable )
This function returns a promise that is fulfilled with an array of promise state snapshots,
but only after all the original promises have settled, i.e. become either fulfilled or
rejected. It resolves all elements of the passed
- Let C be the
this value. - Let promiseCapability be ?
NewPromiseCapability (C). - Let promiseResolve be
Completion (GetPromiseResolve (C)). IfAbruptRejectPromise (promiseResolve, promiseCapability).- Let iteratorRecord be
Completion (GetIterator (iterable,sync )). IfAbruptRejectPromise (iteratorRecord, promiseCapability).- Let result be
Completion (PerformPromiseAllSettled (iteratorRecord, C, promiseCapability, promiseResolve)). - If result is an
abrupt completion , then- If iteratorRecord.[[Done]] is
false , set result toCompletion (IteratorClose (iteratorRecord, result)). IfAbruptRejectPromise (result, promiseCapability).
- If iteratorRecord.[[Done]] is
- Return ! result.
This function requires its
27.2.4.2.1 PerformPromiseAllSettled ( iteratorRecord, constructor, resultCapability, promiseResolve )
The abstract operation PerformPromiseAllSettled takes arguments iteratorRecord
(an
- Let values be a new empty
List . - Let remainingElementsCount be the
Record { [[Value]]: 1 }. - Let index be 0.
- Repeat,
- Let next be ?
IteratorStepValue (iteratorRecord). - If next is
done , then- Set remainingElementsCount.[[Value]] to remainingElementsCount.[[Value]] - 1.
- If remainingElementsCount.[[Value]] = 0, then
- Let valuesArray be
CreateArrayFromList (values). - Perform ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »).
- Let valuesArray be
- Return resultCapability.[[Promise]].
- Append
undefined to values. - Let nextPromise be ?
Call (promiseResolve, constructor, « next »). - Let stepsFulfilled be the algorithm steps defined in
Promise.allSettledResolve Element Functions - Let lengthFulfilled be the number of non-optional parameters
of the function definition in
Promise.allSettledResolve Element Functions - Let onFulfilled be
CreateBuiltinFunction (stepsFulfilled, lengthFulfilled,"" , « [[AlreadyCalled]], [[Index]], [[Values]], [[Capability]], [[RemainingElements]] »). - Let alreadyCalled be the
Record { [[Value]]:false }. - Set onFulfilled.[[AlreadyCalled]] to alreadyCalled.
- Set onFulfilled.[[Index]] to index.
- Set onFulfilled.[[Values]] to values.
- Set onFulfilled.[[Capability]] to resultCapability.
- Set onFulfilled.[[RemainingElements]] to remainingElementsCount.
- Let stepsRejected be the algorithm steps defined in
Promise.allSettledReject Element Functions - Let lengthRejected be the number of non-optional parameters
of the function definition in
Promise.allSettledReject Element Functions - Let onRejected be
CreateBuiltinFunction (stepsRejected, lengthRejected,"" , « [[AlreadyCalled]], [[Index]], [[Values]], [[Capability]], [[RemainingElements]] »). - Set onRejected.[[AlreadyCalled]] to alreadyCalled.
- Set onRejected.[[Index]] to index.
- Set onRejected.[[Values]] to values.
- Set onRejected.[[Capability]] to resultCapability.
- Set onRejected.[[RemainingElements]] to remainingElementsCount.
- Set remainingElementsCount.[[Value]] to remainingElementsCount.[[Value]] + 1.
- Perform ?
Invoke (nextPromise,"then" , « onFulfilled, onRejected »). - Set index to index + 1.
- Let next be ?
27.2.4.2.2 Promise.allSettled Resolve Element
Functions
A Promise.allSettled resolve element function is an anonymous built-in
function that is used to resolve a specific Promise.allSettled element.
Each Promise.allSettled resolve element function has [[Index]], [[Values]], [[Capability]], [[RemainingElements]],
and [[AlreadyCalled]] internal slots.
When a Promise.allSettled resolve element function is called with argument
x, the following steps are taken:
- Let F be the
active function object . - Let alreadyCalled be F.[[AlreadyCalled]].
- If alreadyCalled.[[Value]] is
true , returnundefined . - Set alreadyCalled.[[Value]] to
true . - Let index be F.[[Index]].
- Let values be F.[[Values]].
- Let promiseCapability be F.[[Capability]].
- Let remainingElementsCount be F.[[RemainingElements]].
- Let obj be
OrdinaryObjectCreate (%Object.prototype% ). - Perform !
CreateDataPropertyOrThrow (obj,"status" ,"fulfilled" ). - Perform !
CreateDataPropertyOrThrow (obj,"value" , x). - Set values[index] to obj.
- Set remainingElementsCount.[[Value]] to remainingElementsCount.[[Value]] - 1.
- If remainingElementsCount.[[Value]] = 0,
then
- Let valuesArray be
CreateArrayFromList (values). - Return ?
Call (promiseCapability.[[Resolve]],undefined , « valuesArray »).
- Let valuesArray be
- Return
undefined .
The Promise.allSettled resolve
element function is
27.2.4.2.3 Promise.allSettled Reject Element
Functions
A Promise.allSettled reject element function is an anonymous built-in
function that is used to reject a specific Promise.allSettled element. Each
Promise.allSettled reject element function has [[Index]], [[Values]], [[Capability]], [[RemainingElements]],
and [[AlreadyCalled]] internal slots.
When a Promise.allSettled reject element function is called with argument
x, the following steps are taken:
- Let F be the
active function object . - Let alreadyCalled be F.[[AlreadyCalled]].
- If alreadyCalled.[[Value]] is
true , returnundefined . - Set alreadyCalled.[[Value]] to
true . - Let index be F.[[Index]].
- Let values be F.[[Values]].
- Let promiseCapability be F.[[Capability]].
- Let remainingElementsCount be F.[[RemainingElements]].
- Let obj be
OrdinaryObjectCreate (%Object.prototype% ). - Perform !
CreateDataPropertyOrThrow (obj,"status" ,"rejected" ). - Perform !
CreateDataPropertyOrThrow (obj,"reason" , x). - Set values[index] to obj.
- Set remainingElementsCount.[[Value]] to remainingElementsCount.[[Value]] - 1.
- If remainingElementsCount.[[Value]] = 0,
then
- Let valuesArray be
CreateArrayFromList (values). - Return ?
Call (promiseCapability.[[Resolve]],undefined , « valuesArray »).
- Let valuesArray be
- Return
undefined .
The Promise.allSettled reject
element function is
27.2.4.3 Promise.any ( iterable )
This function returns a promise that is fulfilled by the first given promise to be fulfilled,
or rejected with an AggregateError holding the rejection reasons if all of the
given promises are rejected. It resolves all elements of the passed
- Let C be the
this value. - Let promiseCapability be ?
NewPromiseCapability (C). - Let promiseResolve be
Completion (GetPromiseResolve (C)). IfAbruptRejectPromise (promiseResolve, promiseCapability).- Let iteratorRecord be
Completion (GetIterator (iterable,sync )). IfAbruptRejectPromise (iteratorRecord, promiseCapability).- Let result be
Completion (PerformPromiseAny (iteratorRecord, C, promiseCapability, promiseResolve)). - If result is an
abrupt completion , then- If iteratorRecord.[[Done]] is
false , set result toCompletion (IteratorClose (iteratorRecord, result)). IfAbruptRejectPromise (result, promiseCapability).
- If iteratorRecord.[[Done]] is
- Return ! result.
This function requires its Promise
27.2.4.3.1 PerformPromiseAny ( iteratorRecord, constructor, resultCapability, promiseResolve )
The abstract operation PerformPromiseAny takes arguments iteratorRecord (an
- Let errors be a new empty
List . - Let remainingElementsCount be the
Record { [[Value]]: 1 }. - Let index be 0.
- Repeat,
- Let next be ?
IteratorStepValue (iteratorRecord). - If next is
done , then- Set remainingElementsCount.[[Value]] to remainingElementsCount.[[Value]] - 1.
- If remainingElementsCount.[[Value]] = 0, then
- Let error be a newly created
AggregateError object. - Perform !
DefinePropertyOrThrow (error,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errors) }). - Return
ThrowCompletion (error).
- Let error be a newly created
- Return resultCapability.[[Promise]].
- Append
undefined to errors. - Let nextPromise be ?
Call (promiseResolve, constructor, « next »). - Let stepsRejected be the algorithm steps defined in
Promise.anyReject Element Functions - Let lengthRejected be the number of non-optional parameters
of the function definition in
Promise.anyReject Element Functions - Let onRejected be
CreateBuiltinFunction (stepsRejected, lengthRejected,"" , « [[AlreadyCalled]], [[Index]], [[Errors]], [[Capability]], [[RemainingElements]] »). - Set onRejected.[[AlreadyCalled]] to
false . - Set onRejected.[[Index]] to index.
- Set onRejected.[[Errors]] to errors.
- Set onRejected.[[Capability]] to resultCapability.
- Set onRejected.[[RemainingElements]] to remainingElementsCount.
- Set remainingElementsCount.[[Value]] to remainingElementsCount.[[Value]] + 1.
- Perform ?
Invoke (nextPromise,"then" , « resultCapability.[[Resolve]], onRejected »). - Set index to index + 1.
- Let next be ?
27.2.4.3.2 Promise.any Reject Element Functions
A Promise.any reject element function is an anonymous built-in function that
is used to reject a specific Promise.any element. Each
Promise.any reject element function has [[Index]],
[[Errors]], [[Capability]], [[RemainingElements]], and [[AlreadyCalled]] internal slots.
When a Promise.any reject element function is called with argument
x, the following steps are taken:
- Let F be the
active function object . - If F.[[AlreadyCalled]] is
true , returnundefined . - Set F.[[AlreadyCalled]] to
true . - Let index be F.[[Index]].
- Let errors be F.[[Errors]].
- Let promiseCapability be F.[[Capability]].
- Let remainingElementsCount be F.[[RemainingElements]].
- Set errors[index] to x.
- Set remainingElementsCount.[[Value]] to remainingElementsCount.[[Value]] - 1.
- If remainingElementsCount.[[Value]] = 0,
then
- Let error be a newly created
AggregateError object. - Perform !
DefinePropertyOrThrow (error,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errors) }). - Return ?
Call (promiseCapability.[[Reject]],undefined , « error »).
- Let error be a newly created
- Return
undefined .
The Promise.any reject element
function is
27.2.4.4 Promise.prototype
The initial value of Promise.prototype is the
This property has the attributes { [[Writable]]:
27.2.4.5 Promise.race ( iterable )
This function returns a new promise which is settled in the same way as the first passed promise to settle. It resolves all elements of the passed iterable to promises as it runs this algorithm.
- Let C be the
this value. - Let promiseCapability be ?
NewPromiseCapability (C). - Let promiseResolve be
Completion (GetPromiseResolve (C)). IfAbruptRejectPromise (promiseResolve, promiseCapability).- Let iteratorRecord be
Completion (GetIterator (iterable,sync )). IfAbruptRejectPromise (iteratorRecord, promiseCapability).- Let result be
Completion (PerformPromiseRace (iteratorRecord, C, promiseCapability, promiseResolve)). - If result is an
abrupt completion , then- If iteratorRecord.[[Done]] is
false , set result toCompletion (IteratorClose (iteratorRecord, result)). IfAbruptRejectPromise (result, promiseCapability).
- If iteratorRecord.[[Done]] is
- Return ! result.
If the iterable argument yields no values or if none of the promises yielded by iterable ever settle, then the pending promise returned by this method will never be settled.
This function expects its resolve
method.
27.2.4.5.1 PerformPromiseRace ( iteratorRecord, constructor, resultCapability, promiseResolve )
The abstract operation PerformPromiseRace takes arguments iteratorRecord (an
- Repeat,
- Let next be ?
IteratorStepValue (iteratorRecord). - If next is
done , then- Return resultCapability.[[Promise]].
- Let nextPromise be ?
Call (promiseResolve, constructor, « next »). - Perform ?
Invoke (nextPromise,"then" , « resultCapability.[[Resolve]], resultCapability.[[Reject]] »).
- Let next be ?
27.2.4.6 Promise.reject ( r )
This function returns a new promise rejected with the passed argument.
- Let C be the
this value. - Let promiseCapability be ?
NewPromiseCapability (C). - Perform ?
Call (promiseCapability.[[Reject]],undefined , « r »). - Return promiseCapability.[[Promise]].
This function expects its
27.2.4.7 Promise.resolve ( x )
This function returns either a new promise resolved with the passed argument, or the argument
itself if the argument is a promise produced by this
- Let C be the
this value. - If C
is not an Object , throw aTypeError exception. - Return ?
PromiseResolve (C, x).
This function expects its
27.2.4.7.1 PromiseResolve ( C, x )
The abstract operation PromiseResolve takes arguments C (an Object) and
x (an
- If
IsPromise (x) istrue , then - Let promiseCapability be ?
NewPromiseCapability (C). - Perform ?
Call (promiseCapability.[[Resolve]],undefined , « x »). - Return promiseCapability.[[Promise]].
27.2.4.8 Promise.try ( callback, ...args )
This function performs the following steps when called:
- Let C be the
this value. - If C
is not an Object , throw aTypeError exception. - Let promiseCapability be ?
NewPromiseCapability (C). - Let status be
Completion (Call (callback,undefined , args)). - If status is an
abrupt completion , then- Perform ?
Call (promiseCapability.[[Reject]],undefined , « status.[[Value]] »).
- Perform ?
- Else,
- Perform ?
Call (promiseCapability.[[Resolve]],undefined , « status.[[Value]] »).
- Perform ?
- Return promiseCapability.[[Promise]].
This function expects its
27.2.4.9 Promise.withResolvers ( )
This function returns an object with three properties: a new promise together with the
resolve and reject functions associated with it.
- Let C be the
this value. - Let promiseCapability be ?
NewPromiseCapability (C). - Let obj be
OrdinaryObjectCreate (%Object.prototype% ). - Perform !
CreateDataPropertyOrThrow (obj,"promise" , promiseCapability.[[Promise]]). - Perform !
CreateDataPropertyOrThrow (obj,"resolve" , promiseCapability.[[Resolve]]). - Perform !
CreateDataPropertyOrThrow (obj,"reject" , promiseCapability.[[Reject]]). - Return obj.
27.2.4.10 get Promise [ %Symbol.species% ]
Promise[%Symbol.species%] is an
- Return the
this value.
The value of the
Promise prototype methods normally use their
27.2.5 Properties of the Promise Prototype Object
The Promise prototype object:
- is %Promise.prototype%.
- has a [[Prototype]] internal slot whose value is
%Object.prototype% . - is an
ordinary object . - does not have a [[PromiseState]] internal slot or any of the other internal slots of Promise instances.
27.2.5.1 Promise.prototype.catch ( onRejected )
This method performs the following steps when called:
- Let promise be the
this value. - Return ?
Invoke (promise,"then" , «undefined , onRejected »).
27.2.5.2 Promise.prototype.constructor
The initial value of Promise.prototype.constructor is
27.2.5.3 Promise.prototype.finally ( onFinally )
This method performs the following steps when called:
- Let promise be the
this value. - If promise
is not an Object , throw aTypeError exception. - Let C be ?
SpeciesConstructor (promise,%Promise% ). Assert :IsConstructor (C) istrue .- If
IsCallable (onFinally) isfalse , then- Let thenFinally be onFinally.
- Let catchFinally be onFinally.
- Else,
- Let thenFinallyClosure be a new
Abstract Closure with parameters (value) that captures onFinally and C and performs the following steps when called:- Let result be ?
Call (onFinally,undefined ). - Let p be ?
PromiseResolve (C, result). - Let returnValue be a new
Abstract Closure with no parameters that captures value and performs the following steps when called:- Return value.
- Let valueThunk be
CreateBuiltinFunction (returnValue, 0,"" , « »). - Return ?
Invoke (p,"then" , « valueThunk »).
- Let result be ?
- Let thenFinally be
CreateBuiltinFunction (thenFinallyClosure, 1,"" , « »). - Let catchFinallyClosure be a new
Abstract Closure with parameters (reason) that captures onFinally and C and performs the following steps when called:- Let result be ?
Call (onFinally,undefined ). - Let p be ?
PromiseResolve (C, result). - Let throwReason be a new
Abstract Closure with no parameters that captures reason and performs the following steps when called:- Return
ThrowCompletion (reason).
- Return
- Let thrower be
CreateBuiltinFunction (throwReason, 0,"" , « »). - Return ?
Invoke (p,"then" , « thrower »).
- Let result be ?
- Let catchFinally be
CreateBuiltinFunction (catchFinallyClosure, 1,"" , « »).
- Let thenFinallyClosure be a new
- Return ?
Invoke (promise,"then" , « thenFinally, catchFinally »).
27.2.5.4 Promise.prototype.then ( onFulfilled, onRejected )
This method performs the following steps when called:
- Let promise be the
this value. - If
IsPromise (promise) isfalse , throw aTypeError exception. - Let C be ?
SpeciesConstructor (promise,%Promise% ). - Let resultCapability be ?
NewPromiseCapability (C). - Return
PerformPromiseThen (promise, onFulfilled, onRejected, resultCapability).
27.2.5.4.1 PerformPromiseThen ( promise, onFulfilled, onRejected [ , resultCapability ] )
The abstract operation PerformPromiseThen takes arguments promise (a Promise),
onFulfilled (an
Assert :IsPromise (promise) istrue .- If resultCapability is not present, then
- Set resultCapability to
undefined .
- Set resultCapability to
- If
IsCallable (onFulfilled) isfalse , then- Let onFulfilledJobCallback be
empty .
- Let onFulfilledJobCallback be
- Else,
- Let onFulfilledJobCallback be
HostMakeJobCallback (onFulfilled).
- Let onFulfilledJobCallback be
- If
IsCallable (onRejected) isfalse , then- Let onRejectedJobCallback be
empty .
- Let onRejectedJobCallback be
- Else,
- Let onRejectedJobCallback be
HostMakeJobCallback (onRejected).
- Let onRejectedJobCallback be
- Let fulfillReaction be the
PromiseReaction Record { [[Capability]]: resultCapability, [[Type]]:fulfill , [[Handler]]: onFulfilledJobCallback }. - Let rejectReaction be the
PromiseReaction Record { [[Capability]]: resultCapability, [[Type]]:reject , [[Handler]]: onRejectedJobCallback }. - If promise.[[PromiseState]] is
pending , then- Append fulfillReaction to promise.[[PromiseFulfillReactions]].
- Append rejectReaction to promise.[[PromiseRejectReactions]].
- Else if promise.[[PromiseState]] is
fulfilled , then- Let value be promise.[[PromiseResult]].
- Let fulfillJob be
NewPromiseReactionJob (fulfillReaction, value). - Perform
HostEnqueuePromiseJob (fulfillJob.[[Job]], fulfillJob.[[Realm]]).
- Else,
Assert : The value of promise.[[PromiseState]] isrejected .- Let reason be promise.[[PromiseResult]].
- If promise.[[PromiseIsHandled]] is
false , performHostPromiseRejectionTracker (promise,"handle" ). - Let rejectJob be
NewPromiseReactionJob (rejectReaction, reason). - Perform
HostEnqueuePromiseJob (rejectJob.[[Job]], rejectJob.[[Realm]]).
- Set promise.[[PromiseIsHandled]] to
true . - If resultCapability is
undefined , then- Return
undefined .
- Return
- Else,
- Return resultCapability.[[Promise]].
27.2.5.5 Promise.prototype [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
27.2.6 Properties of Promise Instances
Promise instances are
| Internal Slot | Type | Description |
|---|---|---|
| [[PromiseState]] |
|
Governs how a promise will react to incoming calls to its then
method.
|
| [[PromiseResult]] |
an |
The value with which the promise has been fulfilled or rejected, if any.
|
| [[PromiseFulfillReactions]] |
a |
|
| [[PromiseRejectReactions]] |
a |
|
| [[PromiseIsHandled]] | a Boolean | Indicates whether the promise has ever had a fulfillment or rejection handler; used in unhandled rejection tracking. |
27.3 GeneratorFunction Objects
GeneratorFunctions are functions that are usually created by evaluating
27.3.1 The GeneratorFunction Constructor
The GeneratorFunction
- is %GeneratorFunction%.
- is a subclass of
Function. - creates and initializes a new GeneratorFunction when called as a function rather than as a
constructor . Thus the function callGeneratorFunction (…)is equivalent to the object creation expressionnew GeneratorFunction (…)with the same arguments. - may be used as the value of an
extendsclause of a class definition. Subclassconstructors that intend to inherit the specified GeneratorFunction behaviour must include asupercall to the GeneratorFunctionconstructor to create and initialize subclass instances with the internal slots necessary for built-in GeneratorFunction behaviour. All ECMAScript syntactic forms for defining generatorfunction objects create direct instances of GeneratorFunction. There is no syntactic means to create instances of GeneratorFunction subclasses.
27.3.1.1 GeneratorFunction ( ...parameterArgs, bodyArg )
The last argument (if any) specifies the body (executable code) of a generator function; any preceding arguments specify formal parameters.
This function performs the following steps when called:
- Let C be the
active function object . - If bodyArg is not present, set bodyArg to the empty String.
- Return ?
CreateDynamicFunction (C, NewTarget,generator , parameterArgs, bodyArg).
See NOTE for
27.3.2 Properties of the GeneratorFunction Constructor
The GeneratorFunction
- is a standard built-in
function object that inherits from the Functionconstructor . - has a [[Prototype]] internal slot whose value is
%Function% . - has a
"length" property whose value is1 𝔽. - has a
"name" property whose value is"GeneratorFunction" . - has the following properties:
27.3.2.1 GeneratorFunction.prototype
The initial value of GeneratorFunction.prototype is the
This property has the attributes { [[Writable]]:
27.3.3 Properties of the GeneratorFunction Prototype Object
The GeneratorFunction prototype object:
- is %GeneratorFunction.prototype% (see
Figure 6 ). - is an
ordinary object . - is not a
function object and does not have an [[ECMAScriptCode]] internal slot or any other of the internal slots listed inTable 30 orTable 93 . - has a [[Prototype]] internal slot whose value is
%Function.prototype% .
27.3.3.1 GeneratorFunction.prototype.constructor
The initial value of GeneratorFunction.prototype.constructor is
This property has the attributes { [[Writable]]:
27.3.3.2 GeneratorFunction.prototype.prototype
The initial value of GeneratorFunction.prototype.prototype is
This property has the attributes { [[Writable]]:
27.3.3.3 GeneratorFunction.prototype [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
27.3.4 GeneratorFunction Instances
Every GeneratorFunction instance is an ECMAScript
Each GeneratorFunction instance has the following own properties:
27.3.4.1 length
The specification for the
27.3.4.2 name
The specification for the
27.3.4.3 prototype
Whenever a GeneratorFunction instance is created another
This property has the attributes { [[Writable]]:
Unlike Function instances, the object that is the value of a GeneratorFunction's
27.4 AsyncGeneratorFunction Objects
AsyncGeneratorFunctions are functions that are usually created by evaluating
27.4.1 The AsyncGeneratorFunction Constructor
The AsyncGeneratorFunction
- is %AsyncGeneratorFunction%.
- is a subclass of
Function. - creates and initializes a new AsyncGeneratorFunction when called as a function rather than
as a
constructor . Thus the function callAsyncGeneratorFunction (...)is equivalent to the object creation expressionnew AsyncGeneratorFunction (...)with the same arguments. - may be used as the value of an
extendsclause of a class definition. Subclassconstructors that intend to inherit the specified AsyncGeneratorFunction behaviour must include asupercall to the AsyncGeneratorFunctionconstructor to create and initialize subclass instances with the internal slots necessary for built-in AsyncGeneratorFunction behaviour. All ECMAScript syntactic forms for defining async generatorfunction objects create direct instances of AsyncGeneratorFunction. There is no syntactic means to create instances of AsyncGeneratorFunction subclasses.
27.4.1.1 AsyncGeneratorFunction ( ...parameterArgs, bodyArg )
The last argument (if any) specifies the body (executable code) of an async generator function; any preceding arguments specify formal parameters.
This function performs the following steps when called:
- Let C be the
active function object . - If bodyArg is not present, set bodyArg to the empty String.
- Return ?
CreateDynamicFunction (C, NewTarget,async-generator , parameterArgs, bodyArg).
See NOTE for
27.4.2 Properties of the AsyncGeneratorFunction Constructor
The AsyncGeneratorFunction
- is a standard built-in
function object that inherits from the Functionconstructor . - has a [[Prototype]] internal slot whose value is
%Function% . - has a
"length" property whose value is1 𝔽. - has a
"name" property whose value is"AsyncGeneratorFunction" . - has the following properties:
27.4.2.1 AsyncGeneratorFunction.prototype
The initial value of AsyncGeneratorFunction.prototype is the
This property has the attributes { [[Writable]]:
27.4.3 Properties of the AsyncGeneratorFunction Prototype Object
The AsyncGeneratorFunction prototype object:
- is %AsyncGeneratorFunction.prototype%.
- is an
ordinary object . - is not a
function object and does not have an [[ECMAScriptCode]] internal slot or any other of the internal slots listed inTable 30 orTable 94 . - has a [[Prototype]] internal slot whose value is
%Function.prototype% .
27.4.3.1 AsyncGeneratorFunction.prototype.constructor
The initial value of AsyncGeneratorFunction.prototype.constructor is
This property has the attributes { [[Writable]]:
27.4.3.2 AsyncGeneratorFunction.prototype.prototype
The initial value of AsyncGeneratorFunction.prototype.prototype is
This property has the attributes { [[Writable]]:
27.4.3.3 AsyncGeneratorFunction.prototype [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
27.4.4 AsyncGeneratorFunction Instances
Every AsyncGeneratorFunction instance is an ECMAScript
Each AsyncGeneratorFunction instance has the following own properties:
27.4.4.1 length
The value of the
This property has the attributes { [[Writable]]:
27.4.4.2 name
The specification for the
27.4.4.3 prototype
Whenever an AsyncGeneratorFunction instance is created, another
This property has the attributes { [[Writable]]:
Unlike function instances, the object that is the value of an
AsyncGeneratorFunction's
27.5 Generator Objects
A Generator is created by calling a generator function and conforms to both the
Generator instances directly inherit properties from the initial value of the
27.5.1 The %GeneratorPrototype% Object
The %GeneratorPrototype% object:
- is %GeneratorFunction.prototype.prototype%.
- is an
ordinary object . - is not a Generator instance and does not have a [[GeneratorState]] internal slot.
- has a [[Prototype]] internal slot whose value is
%Iterator.prototype% . - has properties that are indirectly inherited by all Generator instances.
27.5.1.1 %GeneratorPrototype%.constructor
The initial value of .constructor
is
This property has the attributes { [[Writable]]:
27.5.1.2 %GeneratorPrototype%.next ( value )
- Return ?
GeneratorResume (this value, value,empty ).
27.5.1.3 %GeneratorPrototype%.return ( value )
This method performs the following steps when called:
- Let g be the
this value. - Let C be
ReturnCompletion (value). - Return ?
GeneratorResumeAbrupt (g, C,empty ).
27.5.1.4 %GeneratorPrototype%.throw ( exception )
This method performs the following steps when called:
- Let g be the
this value. - Let C be
ThrowCompletion (exception). - Return ?
GeneratorResumeAbrupt (g, C,empty ).
27.5.1.5 %GeneratorPrototype% [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
27.5.2 Properties of Generator Instances
Generator instances are initially created with the internal slots described in
| Internal Slot | Type | Description |
|---|---|---|
| [[GeneratorState]] |
|
The current execution state of the generator. |
| [[GeneratorContext]] |
an |
The |
| [[GeneratorBrand]] |
a String or |
A brand used to distinguish different kinds of generators. The [[GeneratorBrand]] of generators declared by
|
27.5.3 Generator Abstract Operations
27.5.3.1 GeneratorStart ( generator, generatorBody )
The abstract operation GeneratorStart takes arguments generator (a Generator) and
generatorBody (a
Assert : The value of generator.[[GeneratorState]] issuspended-start .- Let genContext be the
running execution context . - Set the Generator component of genContext to generator.
- Let closure be a new
Abstract Closure with no parameters that captures generatorBody and performs the following steps when called:- Let acGenContext be the
running execution context . - Let acGenerator be the Generator component of acGenContext.
- If generatorBody is a
Parse Node , then- Let result be
Completion (Evaluation of generatorBody).
- Let result be
- Else,
Assert : generatorBody is anAbstract Closure with no parameters.- Let result be
Completion (generatorBody()).
Assert : If we return here, the generator either threw an exception or performed either an implicit or explicit return.- Remove acGenContext from the
execution context stack and restore theexecution context that is at the top of theexecution context stack as therunning execution context . - Set acGenerator.[[GeneratorState]] to
completed . - NOTE: Once a generator enters the
completed state it never leaves it and its associatedexecution context is never resumed. Any execution state associated with acGenerator can be discarded at this point. - If result is a
normal completion , then- Let resultValue be
undefined .
- Let resultValue be
- Else if result is a
return completion , then- Let resultValue be result.[[Value]].
- Else,
Assert : result is athrow completion .- Return ? result.
- Return
CreateIteratorResultObject (resultValue,true ).
- Let acGenContext be the
- Set the code evaluation state of genContext such that when evaluation is
resumed for that
execution context , closure will be called with no arguments. - Set generator.[[GeneratorContext]] to genContext.
- Return
unused .
27.5.3.2 GeneratorValidate ( generator, generatorBrand )
The abstract operation GeneratorValidate takes arguments generator (an
- Perform ?
RequireInternalSlot (generator, [[GeneratorState]]). - Perform ?
RequireInternalSlot (generator, [[GeneratorBrand]]). - If generator.[[GeneratorBrand]] is not
generatorBrand, throw a
TypeError exception. Assert : generator also has a [[GeneratorContext]] internal slot.- Let state be generator.[[GeneratorState]].
- If state is
executing , throw aTypeError exception. - Return state.
27.5.3.3 GeneratorResume ( generator, value, generatorBrand )
The abstract operation GeneratorResume takes arguments generator (an
- Let state be ?
GeneratorValidate (generator, generatorBrand). - If state is
completed , returnCreateIteratorResultObject (undefined ,true ). Assert : state is eithersuspended-start orsuspended-yield .- Let genContext be generator.[[GeneratorContext]].
- Let methodContext be the
running execution context . - Suspend methodContext.
- Set generator.[[GeneratorState]] to
executing . - Push genContext onto the
execution context stack ; genContext is now therunning execution context . - Resume the suspended evaluation of
genContext using
NormalCompletion (value) as the result of the operation that suspended it. Let result be the value returned by the resumed computation. Assert : When we return here, genContext has already been removed from theexecution context stack and methodContext is the currentlyrunning execution context .- Return ? result.
27.5.3.4 GeneratorResumeAbrupt ( generator, abruptCompletion, generatorBrand )
The abstract operation GeneratorResumeAbrupt takes arguments generator (an
- Let state be ?
GeneratorValidate (generator, generatorBrand). - If state is
suspended-start , then- Set generator.[[GeneratorState]] to
completed . - NOTE: Once a generator enters the
completed state it never leaves it and its associatedexecution context is never resumed. Any execution state associated with generator can be discarded at this point. - Set state to
completed .
- Set generator.[[GeneratorState]] to
- If state is
completed , then- If abruptCompletion is a
return completion , then- Return
CreateIteratorResultObject (abruptCompletion.[[Value]],true ).
- Return
- Return ? abruptCompletion.
- If abruptCompletion is a
Assert : state issuspended-yield .- Let genContext be generator.[[GeneratorContext]].
- Let methodContext be the
running execution context . - Suspend methodContext.
- Set generator.[[GeneratorState]] to
executing . - Push genContext onto the
execution context stack ; genContext is now therunning execution context . - Resume the suspended evaluation of
genContext using abruptCompletion as the result of
the operation that suspended it. Let result be the
Completion Record returned by the resumed computation. Assert : When we return here, genContext has already been removed from theexecution context stack and methodContext is the currentlyrunning execution context .- Return ? result.
27.5.3.5 GetGeneratorKind ( )
The abstract operation GetGeneratorKind takes no arguments and returns
- Let genContext be the
running execution context . - If genContext does not have a Generator component, return
non-generator . - Let generator be the Generator component of genContext.
- If generator has an [[AsyncGeneratorState]]
internal slot, return
async . - Else, return
sync .
27.5.3.6 GeneratorYield ( iteratorResult )
The abstract operation GeneratorYield takes argument iteratorResult (an Object
that conforms to the
- Let genContext be the
running execution context . Assert : genContext is theexecution context of a generator.- Let generator be the value of the Generator component of genContext.
Assert :GetGeneratorKind () issync .- Set generator.[[GeneratorState]] to
suspended-yield . - Remove genContext from the
execution context stack and restore theexecution context that is at the top of theexecution context stack as therunning execution context . - Let callerContext be the
running execution context . - Resume callerContext passing
NormalCompletion (iteratorResult). If genContext is ever resumed again, let resumptionValue be theCompletion Record with which it is resumed. Assert : If control reaches here, then genContext is therunning execution context again.- Return resumptionValue.
27.5.3.7 Yield ( value )
The abstract operation Yield takes argument value (an
- Let generatorKind be
GetGeneratorKind (). - If generatorKind is
async , return ?AsyncGeneratorYield (?Await (value)). - Otherwise, return ?
GeneratorYield (CreateIteratorResultObject (value,false )).
27.5.3.8 CreateIteratorFromClosure ( closure, generatorBrand, generatorPrototype [ , extraSlots ] )
The abstract operation CreateIteratorFromClosure takes arguments closure (an
- NOTE: closure can contain uses of the
Yield operation to yield anIteratorResult object . - If extraSlots is not present, set extraSlots to a new empty
List . - Let internalSlotsList be the
list-concatenation of extraSlots and « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] ». - Let generator be
OrdinaryObjectCreate (generatorPrototype, internalSlotsList). - Set generator.[[GeneratorBrand]] to generatorBrand.
- Set generator.[[GeneratorState]] to
suspended-start . - Let callerContext be the
running execution context . - Let calleeContext be a new
execution context . - Set the Function of calleeContext to
null . - Set the
Realm of calleeContext tothe current Realm Record . - Set the ScriptOrModule of calleeContext to callerContext's ScriptOrModule.
- If callerContext is not already suspended, suspend callerContext.
- Push calleeContext onto the
execution context stack ; calleeContext is now therunning execution context . - Perform
GeneratorStart (generator, closure). - Remove calleeContext from the
execution context stack and restore callerContext as therunning execution context . - Return generator.
27.6 AsyncGenerator Objects
An AsyncGenerator is created by calling an async generator function and conforms to both the
AsyncGenerator instances directly inherit properties from the initial value of the
27.6.1 The %AsyncGeneratorPrototype% Object
The %AsyncGeneratorPrototype% object:
- is %AsyncGeneratorFunction.prototype.prototype%.
- is an
ordinary object . - is not an AsyncGenerator instance and does not have an [[AsyncGeneratorState]] internal slot.
- has a [[Prototype]] internal slot whose value is
%AsyncIteratorPrototype% . - has properties that are indirectly inherited by all AsyncGenerator instances.
27.6.1.1 %AsyncGeneratorPrototype%.constructor
The initial value of .constructor
is
This property has the attributes { [[Writable]]:
27.6.1.2 %AsyncGeneratorPrototype%.next ( value )
- Let generator be the
this value. - Let promiseCapability be !
NewPromiseCapability (%Promise% ). - Let result be
Completion (AsyncGeneratorValidate (generator,empty )). IfAbruptRejectPromise (result, promiseCapability).- Let state be generator.[[AsyncGeneratorState]].
- If state is
completed , then- Let iteratorResult be
CreateIteratorResultObject (undefined ,true ). - Perform ! Call(promiseCapability.[[Resolve]],
undefined , « iteratorResult »). - Return promiseCapability.[[Promise]].
- Let iteratorResult be
- Let completion be
NormalCompletion (value). - Perform
AsyncGeneratorEnqueue (generator, completion, promiseCapability). - If state is either
suspended-start orsuspended-yield , then- Perform
AsyncGeneratorResume (generator, completion).
- Perform
- Else,
Assert : state is eitherexecuting ordraining-queue .
- Return promiseCapability.[[Promise]].
27.6.1.3 %AsyncGeneratorPrototype%.return ( value )
- Let generator be the
this value. - Let promiseCapability be !
NewPromiseCapability (%Promise% ). - Let result be
Completion (AsyncGeneratorValidate (generator,empty )). IfAbruptRejectPromise (result, promiseCapability).- Let completion be
ReturnCompletion (value). - Perform
AsyncGeneratorEnqueue (generator, completion, promiseCapability). - Let state be generator.[[AsyncGeneratorState]].
- If state is either
suspended-start orcompleted , then- Set generator.[[AsyncGeneratorState]] to
draining-queue . - Perform
AsyncGeneratorAwaitReturn (generator).
- Set generator.[[AsyncGeneratorState]] to
- Else if state is
suspended-yield , then- Perform
AsyncGeneratorResume (generator, completion).
- Perform
- Else,
Assert : state is eitherexecuting ordraining-queue .
- Return promiseCapability.[[Promise]].
27.6.1.4 %AsyncGeneratorPrototype%.throw ( exception )
- Let generator be the
this value. - Let promiseCapability be !
NewPromiseCapability (%Promise% ). - Let result be
Completion (AsyncGeneratorValidate (generator,empty )). IfAbruptRejectPromise (result, promiseCapability).- Let state be generator.[[AsyncGeneratorState]].
- If state is
suspended-start , then- Set generator.[[AsyncGeneratorState]] to
completed . - Set state to
completed .
- Set generator.[[AsyncGeneratorState]] to
- If state is
completed , then- Perform !
Call (promiseCapability.[[Reject]],undefined , « exception »). - Return promiseCapability.[[Promise]].
- Perform !
- Let completion be
ThrowCompletion (exception). - Perform
AsyncGeneratorEnqueue (generator, completion, promiseCapability). - If state is
suspended-yield , then- Perform
AsyncGeneratorResume (generator, completion).
- Perform
- Else,
Assert : state is eitherexecuting ordraining-queue .
- Return promiseCapability.[[Promise]].
27.6.1.5 %AsyncGeneratorPrototype% [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
27.6.2 Properties of AsyncGenerator Instances
AsyncGenerator instances are initially created with the internal slots described below:
| Internal Slot | Type | Description |
|---|---|---|
| [[AsyncGeneratorState]] | The current execution state of the async generator. | |
| [[AsyncGeneratorContext]] | an |
The |
| [[AsyncGeneratorQueue]] | a |
|
| [[GeneratorBrand]] | a String or |
A brand used to distinguish different kinds of async generators. The [[GeneratorBrand]] of async generators declared by
|
27.6.3 AsyncGenerator Abstract Operations
27.6.3.1 AsyncGeneratorRequest Records
An AsyncGeneratorRequest is a
They have the following fields:
| Field Name | Value | Meaning |
|---|---|---|
| [[Completion]] | a |
The |
| [[Capability]] | a |
The promise capabilities associated with this request. |
27.6.3.2 AsyncGeneratorStart ( generator, generatorBody )
The abstract operation AsyncGeneratorStart takes arguments generator (an
AsyncGenerator) and generatorBody (a
Assert : generator.[[AsyncGeneratorState]] issuspended-start .- Let genContext be the
running execution context . - Set the Generator component of genContext to generator.
- Let closure be a new
Abstract Closure with no parameters that captures generatorBody and performs the following steps when called:- Let acGenContext be the
running execution context . - Let acGenerator be the Generator component of acGenContext.
- If generatorBody is a
Parse Node , then- Let result be
Completion (Evaluation of generatorBody).
- Let result be
- Else,
Assert : generatorBody is anAbstract Closure with no parameters.- Let result be
Completion (generatorBody()).
Assert : If we return here, the async generator either threw an exception or performed either an implicit or explicit return.- Remove acGenContext from the
execution context stack and restore theexecution context that is at the top of theexecution context stack as therunning execution context . - Set acGenerator.[[AsyncGeneratorState]]
to
draining-queue . - If result is a
normal completion , set result toNormalCompletion (undefined ). - If result is a
return completion , set result toNormalCompletion (result.[[Value]]). - Perform
AsyncGeneratorCompleteStep (acGenerator, result,true ). - Perform
AsyncGeneratorDrainQueue (acGenerator). - Return
undefined .
- Let acGenContext be the
- Set the code evaluation state of genContext such that when evaluation is
resumed for that
execution context , closure will be called with no arguments. - Set generator.[[AsyncGeneratorContext]] to genContext.
- Set generator.[[AsyncGeneratorQueue]] to a new
empty
List . - Return
unused .
27.6.3.3 AsyncGeneratorValidate ( generator, generatorBrand )
The abstract operation AsyncGeneratorValidate takes arguments generator (an
- Perform ?
RequireInternalSlot (generator, [[AsyncGeneratorContext]]). - Perform ?
RequireInternalSlot (generator, [[AsyncGeneratorState]]). - Perform ?
RequireInternalSlot (generator, [[AsyncGeneratorQueue]]). - If generator.[[GeneratorBrand]] is not
generatorBrand, throw a
TypeError exception. - Return
unused .
27.6.3.4 AsyncGeneratorEnqueue ( generator, completion, promiseCapability )
The abstract operation AsyncGeneratorEnqueue takes arguments generator (an
AsyncGenerator), completion (a
- Let request be
AsyncGeneratorRequest { [[Completion]]: completion, [[Capability]]: promiseCapability }. - Append request to generator.[[AsyncGeneratorQueue]].
- Return
unused .
27.6.3.5 AsyncGeneratorCompleteStep ( generator, completion, done [ , realm ] )
The abstract operation AsyncGeneratorCompleteStep takes arguments generator (an
AsyncGenerator), completion (a
Assert : generator.[[AsyncGeneratorQueue]] is not empty.- Let next be the first element of generator.[[AsyncGeneratorQueue]].
- Remove the first element from generator.[[AsyncGeneratorQueue]].
- Let promiseCapability be next.[[Capability]].
- Let value be completion.[[Value]].
- If completion is a
throw completion , then- Perform !
Call (promiseCapability.[[Reject]],undefined , « value »).
- Perform !
- Else,
Assert : completion is anormal completion .- If realm is present, then
- Let oldRealm be the
running execution context 'sRealm . - Set the
running execution context 'sRealm to realm. - Let iteratorResult be
CreateIteratorResultObject (value, done). - Set the
running execution context 'sRealm to oldRealm.
- Let oldRealm be the
- Else,
- Let iteratorResult be
CreateIteratorResultObject (value, done).
- Let iteratorResult be
- Perform ! Call(promiseCapability.[[Resolve]],
undefined , « iteratorResult »).
- Return
unused .
27.6.3.6 AsyncGeneratorResume ( generator, completion )
The abstract operation AsyncGeneratorResume takes arguments generator (an
AsyncGenerator) and completion (a
Assert : generator.[[AsyncGeneratorState]] is eithersuspended-start orsuspended-yield .- Let genContext be generator.[[AsyncGeneratorContext]].
- Let callerContext be the
running execution context . - Suspend callerContext.
- Set generator.[[AsyncGeneratorState]] to
executing . - Push genContext onto the
execution context stack ; genContext is now therunning execution context . - Resume the suspended evaluation of
genContext using completion as the result of the
operation that suspended it. Let result be the
Completion Record returned by the resumed computation. Assert : result is never anabrupt completion .Assert : When we return here, genContext has already been removed from theexecution context stack and callerContext is the currentlyrunning execution context .- Return
unused .
27.6.3.7 AsyncGeneratorUnwrapYieldResumption ( resumptionValue )
The abstract operation AsyncGeneratorUnwrapYieldResumption takes argument
resumptionValue (a
- If resumptionValue is not a
return completion , return ? resumptionValue. - Let awaited be
Completion (Await (resumptionValue.[[Value]])). - If awaited is a
throw completion , return ? awaited. Assert : awaited is anormal completion .- Return
ReturnCompletion (awaited.[[Value]]).
27.6.3.8 AsyncGeneratorYield ( value )
The abstract operation AsyncGeneratorYield takes argument value (an
- Let genContext be the
running execution context . Assert : genContext is theexecution context of a generator.- Let generator be the value of the Generator component of genContext.
Assert :GetGeneratorKind () isasync .- Let completion be
NormalCompletion (value). Assert : Theexecution context stack has at least two elements.- Let previousContext be the second to top element of the
execution context stack . - Let previousRealm be previousContext's
Realm . - Perform
AsyncGeneratorCompleteStep (generator, completion,false , previousRealm). - Let queue be generator.[[AsyncGeneratorQueue]].
- If queue is not empty, then
- NOTE: Execution continues without suspending the generator.
- Let toYield be the first element of queue.
- Let resumptionValue be
Completion (toYield.[[Completion]]). - Return ?
AsyncGeneratorUnwrapYieldResumption (resumptionValue).
- Else,
- Set generator.[[AsyncGeneratorState]] to
suspended-yield . - Remove genContext from the
execution context stack and restore theexecution context that is at the top of theexecution context stack as therunning execution context . - Let callerContext be the
running execution context . - Resume callerContext passing
undefined . If genContext is ever resumed again, let resumptionValue be theCompletion Record with which it is resumed. Assert : If control reaches here, then genContext is therunning execution context again.- Return ?
AsyncGeneratorUnwrapYieldResumption (resumptionValue).
- Set generator.[[AsyncGeneratorState]] to
27.6.3.9 AsyncGeneratorAwaitReturn ( generator )
The abstract operation AsyncGeneratorAwaitReturn takes argument generator (an
AsyncGenerator) and returns
Assert : generator.[[AsyncGeneratorState]] isdraining-queue .- Let queue be generator.[[AsyncGeneratorQueue]].
Assert : queue is not empty.- Let next be the first element of queue.
- Let completion be
Completion (next.[[Completion]]). Assert : completion is areturn completion .- Let promiseCompletion be
Completion (PromiseResolve (%Promise% , completion.[[Value]])). - If promiseCompletion is an
abrupt completion , then- Perform
AsyncGeneratorCompleteStep (generator, promiseCompletion,true ). - Perform
AsyncGeneratorDrainQueue (generator). - Return
unused .
- Perform
Assert : promiseCompletion is anormal completion .- Let promise be promiseCompletion.[[Value]].
- Let fulfilledClosure be a new
Abstract Closure with parameters (value) that captures generator and performs the following steps when called:Assert : generator.[[AsyncGeneratorState]] isdraining-queue .- Let result be
NormalCompletion (value). - Perform
AsyncGeneratorCompleteStep (generator, result,true ). - Perform
AsyncGeneratorDrainQueue (generator). - Return
undefined .
- Let onFulfilled be
CreateBuiltinFunction (fulfilledClosure, 1,"" , « »). - Let rejectedClosure be a new
Abstract Closure with parameters (reason) that captures generator and performs the following steps when called:Assert : generator.[[AsyncGeneratorState]] isdraining-queue .- Let result be
ThrowCompletion (reason). - Perform
AsyncGeneratorCompleteStep (generator, result,true ). - Perform
AsyncGeneratorDrainQueue (generator). - Return
undefined .
- Let onRejected be
CreateBuiltinFunction (rejectedClosure, 1,"" , « »). - Perform
PerformPromiseThen (promise, onFulfilled, onRejected). - Return
unused .
27.6.3.10 AsyncGeneratorDrainQueue ( generator )
The abstract operation AsyncGeneratorDrainQueue takes argument generator (an
AsyncGenerator) and returns
Assert : generator.[[AsyncGeneratorState]] isdraining-queue .- Let queue be generator.[[AsyncGeneratorQueue]].
- Repeat, while queue is not empty,
- Let next be the first element of queue.
- Let completion be
Completion (next.[[Completion]]). - If completion is a
return completion , then- Perform
AsyncGeneratorAwaitReturn (generator). - Return
unused .
- Perform
- Else,
- If completion is a
normal completion , then- Set completion to
NormalCompletion (undefined ).
- Set completion to
- Perform
AsyncGeneratorCompleteStep (generator, completion,true ).
- If completion is a
- Set generator.[[AsyncGeneratorState]] to
completed . - Return
unused .
27.6.3.11 CreateAsyncIteratorFromClosure ( closure, generatorBrand, generatorPrototype )
The abstract operation CreateAsyncIteratorFromClosure takes arguments closure (an
- NOTE: closure can contain uses of the
Await operation and uses of theYield operation to yield anIteratorResult object . - Let internalSlotsList be « [[AsyncGeneratorState]], [[AsyncGeneratorContext]], [[AsyncGeneratorQueue]], [[GeneratorBrand]] ».
- Let generator be
OrdinaryObjectCreate (generatorPrototype, internalSlotsList). - Set generator.[[GeneratorBrand]] to generatorBrand.
- Set generator.[[AsyncGeneratorState]] to
suspended-start . - Let callerContext be the
running execution context . - Let calleeContext be a new
execution context . - Set the Function of calleeContext to
null . - Set the
Realm of calleeContext tothe current Realm Record . - Set the ScriptOrModule of calleeContext to callerContext's ScriptOrModule.
- If callerContext is not already suspended, suspend callerContext.
- Push calleeContext onto the
execution context stack ; calleeContext is now therunning execution context . - Perform
AsyncGeneratorStart (generator, closure). - Remove calleeContext from the
execution context stack and restore callerContext as therunning execution context . - Return generator.
27.7 AsyncFunction Objects
AsyncFunctions are functions that are usually created by evaluating
27.7.1 The AsyncFunction Constructor
The AsyncFunction
- is %AsyncFunction%.
- is a subclass of
Function. - creates and initializes a new AsyncFunction when called as a function rather than as a
constructor . Thus the function callAsyncFunction(…)is equivalent to the object creation expressionnew AsyncFunction(…)with the same arguments. - may be used as the value of an
extendsclause of a class definition. Subclassconstructors that intend to inherit the specified AsyncFunction behaviour must include asupercall to the AsyncFunctionconstructor to create and initialize a subclass instance with the internal slots necessary for built-in async function behaviour. All ECMAScript syntactic forms for defining asyncfunction objects create direct instances of AsyncFunction. There is no syntactic means to create instances of AsyncFunction subclasses.
27.7.1.1 AsyncFunction ( ...parameterArgs, bodyArg )
The last argument (if any) specifies the body (executable code) of an async function. Any preceding arguments specify formal parameters.
This function performs the following steps when called:
- Let C be the
active function object . - If bodyArg is not present, set bodyArg to the empty String.
- Return ?
CreateDynamicFunction (C, NewTarget,async , parameterArgs, bodyArg).
27.7.2 Properties of the AsyncFunction Constructor
The AsyncFunction
- is a standard built-in
function object that inherits from the Functionconstructor . - has a [[Prototype]] internal slot whose value is
%Function% . - has a
"length" property whose value is1 𝔽. - has a
"name" property whose value is"AsyncFunction" . - has the following properties:
27.7.2.1 AsyncFunction.prototype
The initial value of AsyncFunction.prototype is the
This property has the attributes { [[Writable]]:
27.7.3 Properties of the AsyncFunction Prototype Object
The AsyncFunction prototype object:
- is %AsyncFunction.prototype%.
- is an
ordinary object . - is not a
function object and does not have an [[ECMAScriptCode]] internal slot or any other of the internal slots listed inTable 30 . - has a [[Prototype]] internal slot whose value is
%Function.prototype% .
27.7.3.1 AsyncFunction.prototype.constructor
The initial value of AsyncFunction.prototype.constructor is
This property has the attributes { [[Writable]]:
27.7.3.2 AsyncFunction.prototype [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
27.7.4 AsyncFunction Instances
Every AsyncFunction instance is an ECMAScript
Each AsyncFunction instance has the following own properties:
27.7.4.1 length
The specification for the
27.7.4.2 name
The specification for the
27.7.5 Async Functions Abstract Operations
27.7.5.1 AsyncFunctionStart ( promiseCapability, asyncFunctionBody )
The abstract operation AsyncFunctionStart takes arguments promiseCapability (a
- Let runningContext be the
running execution context . - Let asyncContext be a copy of runningContext.
- NOTE: Copying the execution state is required for
AsyncBlockStart to resume its execution. It is ill-defined to resume a currently executing context. - Perform
AsyncBlockStart (promiseCapability, asyncFunctionBody, asyncContext). - Return
unused .
27.7.5.2 AsyncBlockStart ( promiseCapability, asyncBody, asyncContext )
The abstract operation AsyncBlockStart takes arguments promiseCapability (a
- Let runningContext be the
running execution context . - Let closure be a new
Abstract Closure with no parameters that captures promiseCapability and asyncBody and performs the following steps when called:- Let acAsyncContext be the
running execution context . - If asyncBody is a
Parse Node , then- Let result be
Completion (Evaluation of asyncBody).
- Let result be
- Else,
Assert : asyncBody is anAbstract Closure with no parameters.- Let result be
Completion (asyncBody()).
Assert : If we return here, the async function either threw an exception or performed an implicit or explicit return; all awaiting is done.- Remove acAsyncContext from the
execution context stack and restore theexecution context that is at the top of theexecution context stack as therunning execution context . - If result is a
normal completion , then- Perform !
Call (promiseCapability.[[Resolve]],undefined , «undefined »).
- Perform !
- Else if result is a
return completion , then- Perform ! Call(promiseCapability.[[Resolve]],
undefined , « result.[[Value]] »).
- Perform ! Call(promiseCapability.[[Resolve]],
- Else,
Assert : result is athrow completion .- Perform !
Call (promiseCapability.[[Reject]],undefined , « result.[[Value]] »).
- Return
unused .
- Let acAsyncContext be the
- Set the code evaluation state of asyncContext such that when evaluation
is resumed for that
execution context , closure will be called with no arguments. - Push asyncContext onto the
execution context stack ; asyncContext is now therunning execution context . - Resume the suspended evaluation of asyncContext. Let result be the value returned by the resumed computation.
Assert : When we return here, asyncContext has already been removed from theexecution context stack and runningContext is the currentlyrunning execution context .Assert : result is anormal completion with a value ofunused . The possible sources of this value areAwait or, if the async function doesn't await anything, step2.i above.- Return
unused .
27.7.5.3 Await ( value )
The abstract operation Await takes argument value (an
- Let asyncContext be the
running execution context . - Let promise be ?
PromiseResolve (%Promise% , value). - Let fulfilledClosure be a new
Abstract Closure with parameters (v) that captures asyncContext and performs the following steps when called:- Let prevContext be the
running execution context . - Suspend prevContext.
- Push asyncContext onto the
execution context stack ; asyncContext is now therunning execution context . - Resume the suspended evaluation of
asyncContext using
NormalCompletion (v) as the result of the operation that suspended it. Assert : When we reach this step, asyncContext has already been removed from theexecution context stack and prevContext is the currentlyrunning execution context .- Return
undefined .
- Let prevContext be the
- Let onFulfilled be
CreateBuiltinFunction (fulfilledClosure, 1,"" , « »). - Let rejectedClosure be a new
Abstract Closure with parameters (reason) that captures asyncContext and performs the following steps when called:- Let prevContext be the
running execution context . - Suspend prevContext.
- Push asyncContext onto the
execution context stack ; asyncContext is now therunning execution context . - Resume the suspended evaluation of
asyncContext using
ThrowCompletion (reason) as the result of the operation that suspended it. Assert : When we reach this step, asyncContext has already been removed from theexecution context stack and prevContext is the currentlyrunning execution context .- Return
undefined .
- Let prevContext be the
- Let onRejected be
CreateBuiltinFunction (rejectedClosure, 1,"" , « »). - Perform
PerformPromiseThen (promise, onFulfilled, onRejected). - Remove asyncContext from the
execution context stack and restore theexecution context that is at the top of theexecution context stack as therunning execution context . - Let callerContext be the
running execution context . - Resume callerContext passing
empty . If asyncContext is ever resumed again, let completion be theCompletion Record with which it is resumed. Assert : If control reaches here, then asyncContext is therunning execution context again.- Return completion.
28 Reflection
28.1 The Reflect Object
The Reflect object:
- is %Reflect%.
- is the initial value of the
"Reflect" property of theglobal object . - is an
ordinary object . - has a [[Prototype]] internal slot whose value is
%Object.prototype% . - is not a
function object . - does not have a [[Construct]] internal method; it cannot be used as a
constructor with thenewoperator. - does not have a [[Call]] internal method; it cannot be invoked as a function.
28.1.1 Reflect.apply ( target, thisArgument, argumentsList )
This function performs the following steps when called:
- If
IsCallable (target) isfalse , throw aTypeError exception. - Let args be ?
CreateListFromArrayLike (argumentsList). - Perform
PrepareForTailCall (). - Return ?
Call (target, thisArgument, args).
28.1.2 Reflect.construct ( target, argumentsList [ , newTarget ] )
This function performs the following steps when called:
- If
IsConstructor (target) isfalse , throw aTypeError exception. - If newTarget is not present, set newTarget to target.
- Else if
IsConstructor (newTarget) isfalse , throw aTypeError exception. - Let args be ?
CreateListFromArrayLike (argumentsList). - Return ?
Construct (target, args, newTarget).
28.1.3 Reflect.defineProperty ( target, propertyKey, attributes )
This function performs the following steps when called:
- If target
is not an Object , throw aTypeError exception. - Let key be ?
ToPropertyKey (propertyKey). - Let desc be ?
ToPropertyDescriptor (attributes). - Return ? target.[[DefineOwnProperty]](key, desc).
28.1.4 Reflect.deleteProperty ( target, propertyKey )
This function performs the following steps when called:
- If target
is not an Object , throw aTypeError exception. - Let key be ?
ToPropertyKey (propertyKey). - Return ? target.[[Delete]](key).
28.1.5 Reflect.get ( target, propertyKey [ , receiver ] )
This function performs the following steps when called:
- If target
is not an Object , throw aTypeError exception. - Let key be ?
ToPropertyKey (propertyKey). - If receiver is not present, then
- Set receiver to target.
- Return ? target.[[Get]](key, receiver).
28.1.6 Reflect.getOwnPropertyDescriptor ( target, propertyKey )
This function performs the following steps when called:
- If target
is not an Object , throw aTypeError exception. - Let key be ?
ToPropertyKey (propertyKey). - Let desc be ? target.[[GetOwnProperty]](key).
- Return
FromPropertyDescriptor (desc).
28.1.7 Reflect.getPrototypeOf ( target )
This function performs the following steps when called:
- If target
is not an Object , throw aTypeError exception. - Return ? target.[[GetPrototypeOf]]().
28.1.8 Reflect.has ( target, propertyKey )
This function performs the following steps when called:
- If target
is not an Object , throw aTypeError exception. - Let key be ?
ToPropertyKey (propertyKey). - Return ? target.[[HasProperty]](key).
28.1.9 Reflect.isExtensible ( target )
This function performs the following steps when called:
- If target
is not an Object , throw aTypeError exception. - Return ? target.[[IsExtensible]]().
28.1.10 Reflect.ownKeys ( target )
This function performs the following steps when called:
- If target
is not an Object , throw aTypeError exception. - Let keys be ? target.[[OwnPropertyKeys]]().
- Return
CreateArrayFromList (keys).
28.1.11 Reflect.preventExtensions ( target )
This function performs the following steps when called:
- If target
is not an Object , throw aTypeError exception. - Return ? target.[[PreventExtensions]]().
28.1.12 Reflect.set ( target, propertyKey, V [ , receiver ] )
This function performs the following steps when called:
- If target
is not an Object , throw aTypeError exception. - Let key be ?
ToPropertyKey (propertyKey). - If receiver is not present, then
- Set receiver to target.
- Return ? target.[[Set]](key, V, receiver).
28.1.13 Reflect.setPrototypeOf ( target, proto )
This function performs the following steps when called:
- If target
is not an Object , throw aTypeError exception. - If proto
is not an Object and proto is notnull , throw aTypeError exception. - Return ? target.[[SetPrototypeOf]](proto).
28.1.14 Reflect [ %Symbol.toStringTag% ]
The initial value of the
This property has the attributes { [[Writable]]:
28.2 Proxy Objects
28.2.1 The Proxy Constructor
The Proxy
- is %Proxy%.
- is the initial value of the
"Proxy" property of theglobal object . - creates and initializes a new Proxy object when called as a
constructor . - is not intended to be called as a function and will throw an exception when called in that manner.
28.2.1.1 Proxy ( target, handler )
This function performs the following steps when called:
- If NewTarget is
undefined , throw aTypeError exception. - Return ?
ProxyCreate (target, handler).
28.2.2 Properties of the Proxy Constructor
The Proxy
- has a [[Prototype]] internal slot whose value is
%Function.prototype% . - does not have a
"prototype" property because Proxy objects do not have a [[Prototype]] internal slot that requires initialization. - has the following properties:
28.2.2.1 Proxy.revocable ( target, handler )
This function creates a revocable Proxy object.
It performs the following steps when called:
- Let proxy be ?
ProxyCreate (target, handler). - Let revokerClosure be a new
Abstract Closure with no parameters that captures nothing and performs the following steps when called:- Let F be the
active function object . - Let p be F.[[RevocableProxy]].
- If p is
null , returnundefined . - Set F.[[RevocableProxy]] to
null . Assert : p is aProxy exotic object .- Set p.[[ProxyTarget]] to
null . - Set p.[[ProxyHandler]] to
null . - Return
undefined .
- Let F be the
- Let revoker be
CreateBuiltinFunction (revokerClosure, 0,"" , « [[RevocableProxy]] »). - Set revoker.[[RevocableProxy]] to proxy.
- Let result be
OrdinaryObjectCreate (%Object.prototype% ). - Perform !
CreateDataPropertyOrThrow (result,"proxy" , proxy). - Perform !
CreateDataPropertyOrThrow (result,"revoke" , revoker). - Return result.
28.3 Module Namespace Objects
A Module Namespace Object is a
In addition to the properties specified in
28.3.1 %Symbol.toStringTag%
The initial value of the
This property has the attributes { [[Writable]]:
29 Memory Model
The memory consistency model, or memory model, specifies the possible orderings
of
The memory model is defined as relational constraints on events introduced by
This section provides an axiomatic model on events introduced by the
29.1 Memory Model Fundamentals
Shared memory accesses (reads and writes) are divided into two groups, atomic accesses and data
accesses, defined below. Atomic accesses are sequentially consistent, i.e., there is a strict total
ordering of events agreed upon by all
No orderings weaker than sequentially consistent and stronger than unordered, such as release-acquire, are supported.
A Shared Data Block event is either a
ReadSharedMemory, WriteSharedMemory, or ReadModifyWriteSharedMemory
| Field Name | Value | Meaning |
|---|---|---|
| [[Order]] | The weakest ordering guaranteed by the |
|
| [[NoTear]] | a Boolean | Whether this event is allowed to read from multiple write events with equal range as this event. |
| [[Block]] | a |
The block the event operates on. |
| [[ByteIndex]] | a non-negative |
The byte address of the read in [[Block]]. |
| [[ElementSize]] | a non-negative |
The size of the read. |
| Field Name | Value | Meaning |
|---|---|---|
| [[Order]] | The weakest ordering guaranteed by the |
|
| [[NoTear]] | a Boolean | Whether this event is allowed to be read from multiple read events with equal range as this event. |
| [[Block]] | a |
The block the event operates on. |
| [[ByteIndex]] | a non-negative |
The byte address of the write in [[Block]]. |
| [[ElementSize]] | a non-negative |
The size of the write. |
| [[Payload]] | a |
The |
| Field Name | Value | Meaning |
|---|---|---|
| [[Order]] | Read-modify-write events are always sequentially consistent. | |
| [[NoTear]] | Read-modify-write events cannot tear. | |
| [[Block]] | a |
The block the event operates on. |
| [[ByteIndex]] | a non-negative |
The byte address of the read-modify-write in [[Block]]. |
| [[ElementSize]] | a non-negative |
The size of the read-modify-write. |
| [[Payload]] | a |
The |
| [[ModifyOp]] | a |
An abstract closure that returns a modified |
These events are introduced by
Some operations may also introduce Synchronize events. A Synchronize event has no fields, and exists purely to directly constrain the permitted orderings of other events.
In addition to
Let the range of a ReadSharedMemory, WriteSharedMemory, or ReadModifyWriteSharedMemory event be the
Set of contiguous
Examples of postMessage in a browser), starting and stopping
Events are ordered within
29.2 Agent Events Records
An Agent Events Record is a
| Field Name | Value | Meaning |
|---|---|---|
| [[AgentSignifier]] | an |
The |
| [[EventList]] | a |
Events are appended to the list during evaluation. |
| [[AgentSynchronizesWith]] | a |
29.3 Chosen Value Records
A Chosen Value Record is a
| Field Name | Value | Meaning |
|---|---|---|
| [[Event]] | a |
The |
| [[ChosenValue]] | a |
The bytes that were nondeterministically chosen during evaluation. |
29.4 Candidate Executions
A candidate execution of the evaluation of
an
| Field Name | Value | Meaning |
|---|---|---|
| [[EventsRecords]] | a |
Maps an |
| [[ChosenValues]] | a |
Maps |
An empty candidate execution is a
candidate execution
29.5 Abstract Operations for the Memory Model
29.5.1 EventSet ( execution )
The abstract operation EventSet takes argument execution (a
- Let events be an empty Set.
- For each
Agent Events Record aer of execution.[[EventsRecords]], do- For each event E of aer.[[EventList]], do
- Add E to events.
- For each event E of aer.[[EventList]], do
- Return events.
29.5.2 SharedDataBlockEventSet ( execution )
The abstract operation SharedDataBlockEventSet takes argument execution (a
- Let events be an empty Set.
- For each event E of
EventSet (execution), do- If E is a
ReadSharedMemory ,WriteSharedMemory , orReadModifyWriteSharedMemory event, add E to events.
- If E is a
- Return events.
29.5.3 HostEventSet ( execution )
The abstract operation HostEventSet takes argument execution (a
- Let events be an empty Set.
- For each event E of
EventSet (execution), do- If E is not in
SharedDataBlockEventSet (execution), add E to events.
- If E is not in
- Return events.
29.5.4 ComposeWriteEventBytes ( execution, byteIndex, Ws )
The abstract operation ComposeWriteEventBytes takes arguments execution (a
- Let byteLocation be byteIndex.
- Let bytesRead be a new empty
List . - For each element W of Ws, do
Assert : W has byteLocation in its range.- Let payloadIndex be byteLocation - W.[[ByteIndex]].
- If W is a
WriteSharedMemory event, then- Let byte be W.[[Payload]][payloadIndex].
- Else,
Assert : W is aReadModifyWriteSharedMemory event.- Let bytes be
ValueOfReadEvent (execution, W). - Let bytesModified be W.[[ModifyOp]](bytes, W.[[Payload]]).
- Let byte be bytesModified[payloadIndex].
- Append byte to bytesRead.
- Set byteLocation to byteLocation + 1.
- Return bytesRead.
The read-modify-write modification [[ModifyOp]] is given by the
function properties on the Atomics object that introduce
This abstract operation composes a
29.5.5 ValueOfReadEvent ( execution, R )
The abstract operation ValueOfReadEvent takes arguments execution (a
- Let Ws be
reads-bytes-from (R) in execution. Assert : Ws is aList ofWriteSharedMemory orReadModifyWriteSharedMemory events with length equal to R.[[ElementSize]].- Return
ComposeWriteEventBytes (execution, R.[[ByteIndex]], Ws).
29.6 Relations of Candidate Executions
The following relations and mathematical functions are parameterized over a particular
29.6.1 is-agent-order-before
For a
- For events E and D, E is-agent-order-before D in
execution if there is some
Agent Events Record aer in execution.[[EventsRecords]] such that aer.[[EventList]] contains both E and D and E is before D inList order of aer.[[EventList]].
Each
29.6.2 reads-bytes-from
For a
-
For each
ReadSharedMemory orReadModifyWriteSharedMemory event R inSharedDataBlockEventSet (execution), reads-bytes-from(R) in execution is aList of length R.[[ElementSize]] whose elements areWriteSharedMemory orReadModifyWriteSharedMemory events Ws such that all of the following are true.- Each event W with index i in Ws has R.[[ByteIndex]] + i in its range.
- R is not in Ws.
A
29.6.3 reads-from
For a
- For events R and W, R reads-from W in
execution if
SharedDataBlockEventSet (execution) contains both R and W, andreads-bytes-from (R) in execution contains W.
29.6.4 host-synchronizes-with
For a
- If E host-synchronizes-with D in execution,
HostEventSet (execution) contains E and D. - There is no cycle in the union of host-synchronizes-with and
is-agent-order-before in execution.
For two
29.6.5 synchronizes-with
For a
-
For events R and W, W synchronizes-with R in
execution if R
reads-from W in execution, R.[[Order]] isseq-cst , W.[[Order]] isseq-cst , and R and W have equal ranges. -
For each element eventsRecord of execution.[[EventsRecords]], the following is true.
- For events S and Sw, S synchronizes-with Sw in execution if eventsRecord.[[AgentSynchronizesWith]] contains (S, Sw).
- For events E and D, E synchronizes-with D in execution if execution.[[HostSynchronizesWith]] contains (E, D).
Owing to convention in
In a
In a
For
29.6.6 happens-before
For a
-
For events E and D, E happens-before D in execution if any of the following conditions are true.
- E
is-agent-order-before D in execution. - E
synchronizes-with D in execution. SharedDataBlockEventSet (execution) contains both E and D, E.[[Order]] isinit , and E and D have overlapping ranges.- There is an event F such that E happens-before F and F happens-before D in execution.
- E
Because happens-before is a superset of
29.7 Properties of Valid Executions
29.7.1 Valid Chosen Reads
A
- For each
ReadSharedMemory orReadModifyWriteSharedMemory event R ofSharedDataBlockEventSet (execution), do- Let chosenValueRecord be the element of execution.[[ChosenValues]] whose [[Event]] field is R.
- Let chosenValue be chosenValueRecord.[[ChosenValue]].
- Let readValue be
ValueOfReadEvent (execution, R). - Let chosenLen be the number of elements in chosenValue.
- Let readLen be the number of elements in readValue.
- If chosenLen ≠ readLen, then
- Return
false .
- Return
- If chosenValue[i] ≠ readValue[i] for
some
integer i in theinterval from 0 (inclusive) to chosenLen (exclusive), then- Return
false .
- Return
- Return
true .
29.7.2 Coherent Reads
A
- For each
ReadSharedMemory orReadModifyWriteSharedMemory event R ofSharedDataBlockEventSet (execution), do- Let Ws be
reads-bytes-from (R) in execution. - Let byteLocation be R.[[ByteIndex]].
- For each element W of Ws, do
- If R
happens-before W in execution, then- Return
false .
- Return
- If there exists a
WriteSharedMemory orReadModifyWriteSharedMemory event V that has byteLocation in its range such that Whappens-before V in execution and Vhappens-before R in execution, then- Return
false .
- Return
- Set byteLocation to byteLocation + 1.
- If R
- Let Ws be
- Return
true .
29.7.3 Tear Free Reads
A
- For each
ReadSharedMemory orReadModifyWriteSharedMemory event R ofSharedDataBlockEventSet (execution), do- If R.[[NoTear]] is
true , thenAssert : The remainder of dividing R.[[ByteIndex]] by R.[[ElementSize]] is 0.- For each event W such that R
reads-from W in execution and W.[[NoTear]] istrue , do- If R and W have equal ranges and there
exists an event V such that V and
W have equal ranges, V.[[NoTear]] is
true , W and V are not the sameShared Data Block event , and Rreads-from V in execution, then- Return
false .
- Return
- If R and W have equal ranges and there
exists an event V such that V and
W have equal ranges, V.[[NoTear]] is
- If R.[[NoTear]] is
- Return
true .
An event's [[NoTear]] field is
Intuitively, this requirement says when a memory range is accessed in an aligned fashion
via an
29.7.4 Sequentially Consistent Atomics
For a
- For events E and D, E is-memory-order-before D
in execution if E
happens-before D in execution. -
For events R and W such that R
reads-from W in execution, there is noWriteSharedMemory orReadModifyWriteSharedMemory event V inSharedDataBlockEventSet (execution) such that V.[[Order]] isseq-cst , W is-memory-order-before V in execution, V is-memory-order-before R in execution, and any of the following conditions are true.- W
synchronizes-with R in execution, and V and R have equal ranges. - W
happens-before R and Vhappens-before R in execution, W.[[Order]] isseq-cst , and W and V have equal ranges. - W
happens-before R and Whappens-before V in execution, R.[[Order]] isseq-cst , and V and R have equal ranges.
Note 1 This clause additionally constrains
seq-cst events on equal ranges. - W
-
For each
WriteSharedMemory orReadModifyWriteSharedMemory event W inSharedDataBlockEventSet (execution), if W.[[Order]] isseq-cst , then it is not the case that there is an infinite number ofReadSharedMemory orReadModifyWriteSharedMemory events inSharedDataBlockEventSet (execution) with equal range that is memory-order before W.Note 2
A
While is-memory-order-before includes all events in
29.7.5 Valid Executions
A
- The
host provides ahost-synchronizes-with Relation for execution. - execution admits a
happens-before Relation that is astrict partial order . - execution has valid chosen reads.
- execution has coherent reads.
- execution has tear free reads.
- execution has sequentially consistent atomics.
All programs have at least one valid execution.
29.8 Races
For an execution execution and events E and D that are contained in
- If E and D are not the same
Shared Data Block event , then- If it is not the case that both E
happens-before D in execution and Dhappens-before E in execution, then- If E and D are both
WriteSharedMemory orReadModifyWriteSharedMemory events and E and D do not have disjoint ranges, then- Return
true .
- Return
- If E
reads-from D in execution or Dreads-from E in execution, then- Return
true .
- Return
- If E and D are both
- If it is not the case that both E
- Return
false .
29.9 Data Races
For an execution execution and events E and D that are contained in
- If E and D are in a
race in execution, then- If E.[[Order]] is not
seq-cst or D.[[Order]] is notseq-cst , then- Return
true .
- Return
- If E and D have overlapping ranges, then
- Return
true .
- Return
- If E.[[Order]] is not
- Return
false .
29.10 Data Race Freedom
An execution execution is data race free if there are no two
events in
A program is data race free if all its executions are data race free.
The
29.11 Shared Memory Guidelines
The following are guidelines for ECMAScript programmers working with shared memory.
We recommend programs be kept
More generally, even if a program is not
The following are guidelines for ECMAScript implementers writing compiler transformations for programs using shared memory.
It is desirable to allow most program transformations that are valid in a single-
Let an agent-order slice be the subset
of the
Let possible read values of a read event be the set of all values of
Any transformation of an agent-order slice that is valid in the absence of shared memory is valid in the presence of shared memory, with the following exceptions.
-
Atomics are carved in stone: Program transformations must not cause the
seq-cst events in an agent-order slice to be reordered with itsunordered operations, nor itsseq-cst operations to be reordered with each other, nor may a program transformation remove aseq-cst operation from theis-agent-order-before Relation .(In practice, the prohibition on reorderings forces a compiler to assume that every
seq-cst operation is a synchronization and included in the finalis-memory-order-before Relation , which it would usually have to assume anyway in the absence of inter-agent program analysis. It also forces the compiler to assume that every call where the callee's effects on the memory-order are unknown may containseq-cst operations.) -
Reads must be stable: Any given shared memory read must only observe a single value in an execution.
(For example, if what is semantically a single read in the program is executed multiple times then the program is subsequently allowed to observe only one of the values read. A transformation known as rematerialization can violate this rule.)
-
Writes must be stable: All observable writes to shared memory must follow from program semantics in an execution.
(For example, a transformation may not introduce certain observable writes, such as by using read-modify-write operations on a larger location to write a smaller datum, writing a value to memory that the program could not have written, or writing a just-read value back to the location it was read from, if that location could have been overwritten by another
agent after the read.) -
Possible read values must be non-empty: Program transformations cannot cause the possible read values of a shared memory read to become empty.
(Counterintuitively, this rule in effect restricts transformations on writes, because writes have force in
memory model insofar as to be read by read events. For example, writes may be moved and coalesced and sometimes reordered between twoseq-cst operations, but the transformation may not remove every write that updates a location; some write must be preserved.)
Examples of transformations that remain valid are: merging multiple non-atomic reads from the
same location, reordering non-atomic reads, introducing speculative non-atomic reads,
merging multiple non-atomic writes to the same location, reordering non-atomic writes to
different locations, and hoisting non-atomic reads out of loops even if that affects
termination. Note in general that aliased
The following are guidelines for ECMAScript implementers generating machine code for shared memory accesses.
For architectures with memory models no weaker than those of ARM or Power, non-atomic stores
and loads may be compiled to bare stores and loads on the target architecture. Atomic stores
and loads may be compiled down to instructions that guarantee sequential consistency. If no
such instructions exist, memory barriers are to be employed, such as placing barriers on
both sides of a bare store or load. Read-modify-write operations may be compiled to
read-modify-write instructions on the target architecture, such as
LOCK-prefixed instructions on x86, load-exclusive/store-exclusive instructions
on ARM, and load-link/store-conditional instructions on Power.
Specifically, the
- Every atomic operation in the program is assumed to be necessary.
- Atomic operations are never rearranged with each other or with non-atomic operations.
- Functions are always assumed to perform atomic operations.
- Atomic operations are never implemented as read-modify-write operations on larger data, but as non-lock-free atomics if the platform does not have atomic operations of the appropriate size. (We already assume that every platform has normal memory access operations of every interesting size.)
Naive code generation uses these patterns:
- Regular loads and stores compile to single load and store instructions.
- Lock-free atomic loads and stores compile to a full (sequentially consistent) fence, a regular load or store, and a full fence.
- Lock-free atomic read-modify-write accesses compile to a full fence, an atomic read-modify-write instruction sequence, and a full fence.
- Non-lock-free atomics compile to a spinlock acquire, a full fence, a series of non-atomic load and store instructions, a full fence, and a spinlock release.
That mapping is correct so long as an atomic operation on an address range does not race with
a non-atomic write or with an atomic operation of different size. However, that is all we
need: the
Local improvements to those basic patterns are also allowed, subject to the constraints of
the
- There are obvious platform-dependent improvements that remove redundant fences. For
example, on x86 the fences around lock-free atomic loads and stores can always be
omitted except for the fence following a store, and no fence is needed for lock-free
read-modify-write instructions, as these all use
LOCK-prefixed instructions. On many platforms there are fences of several strengths, and weaker fences can be used in certain contexts without destroying sequential consistency. - Most modern platforms support lock-free atomics for all the data sizes required by ECMAScript atomics. Should non-lock-free atomics be needed, the fences surrounding the body of the atomic operation can usually be folded into the lock and unlock steps. The simplest solution for non-lock-free atomics is to have a single lock word per SharedArrayBuffer.
- There are also more complicated platform-dependent local improvements, requiring some code analysis. For example, two back-to-back fences often have the same effect as a single fence, so if code is generated for two atomic operations in sequence, only a single fence need separate them. On x86, even a single fence separating atomic stores can be omitted, as the fence following a store is only needed to separate the store from a subsequent load.
Annex A (informative) Grammar Summary
A.1 Lexical Grammar
A.2 Expressions
When processing an instance of the production
the interpretation of
When processing an instance of the production
the interpretation of
In certain circumstances when processing an instance of the production
the interpretation of
A.3 Statements
A.4 Functions and Classes
When processing an instance of the production
the interpretation of
When processing an instance of the production
the interpretation of
A.5 Scripts and Modules
A.6 Number Conversions
All grammar symbols not explicitly defined by the
A.7 Time Zone Offset String Format
A.8 Regular Expressions
Each \u u u \u
Annex B (normative) Additional ECMAScript Features for Web Browsers
The ECMAScript language syntax and semantics defined in this annex are required when the ECMAScript
This annex describes various legacy features and other characteristics of web browser ECMAScript
These features are not considered part of the core ECMAScript language. Programmers should not use or assume the existence of these features and behaviours when writing new ECMAScript code. ECMAScript implementations are discouraged from implementing these features unless the implementation is part of a web browser or is required to run the same legacy ECMAScript code that web browsers encounter.
B.1 Additional Syntax
B.1.1 HTML-like Comments
The syntax and semantics of
Syntax
Similar to a
B.1.2 Regular Expressions Patterns
The syntax of
This alternative pattern grammar and semantics only changes the syntax and semantics of BMP
patterns. The following grammar extensions include productions parameterized with the
[UnicodeMode] parameter. However, none of these extensions change the syntax of Unicode patterns
recognized when parsing with the [UnicodeMode] parameter present on the
Syntax
When the same left-hand sides occurs with both [+UnicodeMode] and [~UnicodeMode] guards it is to control the disambiguation priority.
B.1.2.1 Static Semantics: Early Errors
The semantics of
- It is a Syntax Error if any source text is matched by this production.
Additionally, the rules for the following productions are modified with the addition of the highlighted text:
-
It is a Syntax Error if
IsCharacterClass of the firstClassAtom istrue orIsCharacterClass of the secondClassAtom istrue and this production has a [UnicodeMode] parameter. -
It is a Syntax Error if
IsCharacterClass of the firstClassAtom isfalse ,IsCharacterClass of the secondClassAtom isfalse , and theCharacterValue of the firstClassAtom is strictly greater than theCharacterValue of the secondClassAtom .
-
It is a Syntax Error if
IsCharacterClass ofClassAtomNoDash istrue orIsCharacterClass ofClassAtom istrue and this production has a [UnicodeMode] parameter. -
It is a Syntax Error if
IsCharacterClass ofClassAtomNoDash isfalse ,IsCharacterClass ofClassAtom isfalse , and theCharacterValue ofClassAtomNoDash is strictly greater than theCharacterValue ofClassAtom .
B.1.2.2 Static Semantics: CountLeftCapturingParensWithin and CountLeftCapturingParensBefore
In the definitions of
B.1.2.3 Static Semantics: IsCharacterClass
The semantics of
- Return
false .
B.1.2.4 Static Semantics: CharacterValue
The semantics of
- Return the numeric value of U+005C (REVERSE SOLIDUS).
- Let ch be the code point matched by
ClassControlLetter . - Let i be the numeric value of ch.
- Return the remainder of dividing i by 32.
- Return the MV of
LegacyOctalEscapeSequence (see12.9.4.3 ).
B.1.2.5 Runtime Semantics: CompileSubpattern
The semantics of
The rule for
The rule for
The rule for
B.1.2.6 Runtime Semantics: CompileAssertion
B.1.2.7 Runtime Semantics: CompileAtom
- Let A be the
CharSet containing the single character\U+005C (REVERSE SOLIDUS). - Return
CharacterSetMatcher (rer, A,false , direction).
- Let ch be the character represented by
ExtendedPatternCharacter . - Let A be a one-element
CharSet containing the character ch. - Return
CharacterSetMatcher (rer, A,false , direction).
B.1.2.8 Runtime Semantics: CompileToCharSet
The semantics of
The following two rules replace the corresponding rules of
- Let A be
CompileToCharSet of the firstClassAtom with argument rer. - Let B be
CompileToCharSet of the secondClassAtom with argument rer. - Let C be
CompileToCharSet ofClassContents with argument rer. - Let D be
CharacterRangeOrUnion (rer, A, B). - Return the union of D and C.
- Let A be
CompileToCharSet ofClassAtomNoDash with argument rer. - Let B be
CompileToCharSet ofClassAtom with argument rer. - Let C be
CompileToCharSet ofClassContents with argument rer. - Let D be
CharacterRangeOrUnion (rer, A, B). - Return the union of D and C.
In addition, the following rules are added to
- Let cv be the
CharacterValue of thisClassEscape . - Let c be the character whose character value is cv.
- Return the
CharSet containing the single character c.
- Return the
CharSet containing the single character\U+005C (REVERSE SOLIDUS).
\c within a character class where it is not followed by an acceptable
control character.
B.1.2.8.1 CharacterRangeOrUnion ( rer, A, B )
The abstract operation CharacterRangeOrUnion takes arguments rer (a
- If
HasEitherUnicodeFlag (rer) isfalse , then - Return
CharacterRange (A, B).
B.1.2.9 Static Semantics: ParsePattern ( patternText, u, v )
The semantics of
The abstract operation
- If v is
true and u istrue , then- Let parseResult be a
List containing one or moreSyntaxError objects.
- Let parseResult be a
- Else if v is
true , then - Else if u is
true , then - Else,
- Return parseResult.
B.2 Additional Built-in Properties
When the ECMAScript
B.2.1 Additional Properties of the Global Object
The entries in
| Intrinsic Name | Global Name | ECMAScript Language Association |
|---|---|---|
|
|
escape
|
The escape function ( |
|
|
unescape
|
The unescape function ( |
B.2.1.1 escape ( string )
This function is a property of the
When replacing a code unit of numeric value less than or equal to 0x00FF, a two-digit escape
sequence of the form %xx is used. When replacing a code unit of
numeric value strictly greater than 0x00FF, a four-digit escape sequence of the form
%uxxxx is used.
It is the %escape% intrinsic object.
It performs the following steps when called:
- Set string to ?
ToString (string). - Let len be the length of string.
- Let R be the empty String.
- Let unescapedSet be the
string-concatenation ofthe ASCII word characters and"@*+-./" . - Let k be 0.
- Repeat, while k < len,
- Let C be the code unit at index k within string.
- If unescapedSet contains C, then
- Let S be C.
- Else,
- Let n be the numeric value of C.
- If n < 256, then
- Let hex be the String representation of n, formatted as an uppercase hexadecimal number.
- Let S be the
string-concatenation of"%" andStringPad (hex, 2,"0" ,start ).
- Else,
- Let hex be the String representation of n, formatted as an uppercase hexadecimal number.
- Let S be the
string-concatenation of"%u" andStringPad (hex, 4,"0" ,start ).
- Set R to the
string-concatenation of R and S. - Set k to k + 1.
- Return R.
The encoding is partly based on the encoding described in RFC 1738, but the entire encoding specified in this standard is described above without regard to the contents of RFC 1738. This encoding does not reflect changes to RFC 1738 made by RFC 3986.
B.2.1.2 unescape ( string )
This function is a property of the escape function is replaced with the code unit that it represents.
It is the %unescape% intrinsic object.
It performs the following steps when called:
- Set string to ?
ToString (string). - Let len be the length of string.
- Let R be the empty String.
- Let k be 0.
- Repeat, while k < len,
- Let C be the code unit at index k within string.
- If C is the code unit 0x0025 (PERCENT SIGN), then
- Let hexDigits be the empty String.
- Let optionalAdvance be 0.
- If k + 5 < len and the code unit at index
k + 1 within string is the code unit 0x0075
(LATIN SMALL LETTER U), then
- Set hexDigits to the
substring of string from k + 2 to k + 6. - Set optionalAdvance to 5.
- Set hexDigits to the
- Else if k + 3 ≤ len, then
- Set hexDigits to the
substring of string from k + 1 to k + 3. - Set optionalAdvance to 2.
- Set hexDigits to the
- Let parseResult be
ParseText (hexDigits,HexDigits ).[~Sep] - If parseResult is a
Parse Node , then- Let n be the MV of parseResult.
- Set C to the code unit whose numeric value is n.
- Set k to k + optionalAdvance.
- Set R to the
string-concatenation of R and C. - Set k to k + 1.
- Return R.
B.2.2 Additional Properties of the String.prototype Object
B.2.2.1 String.prototype.substr ( start, length )
This method returns a
It performs the following steps when called:
- Let O be ?
RequireObjectCoercible (this value). - Let S be ?
ToString (O). - Let size be the length of S.
- Let intStart be ?
ToIntegerOrInfinity (start). - If intStart = -∞, set intStart to 0.
- Else if intStart < 0, set intStart to
max (size + intStart, 0). - Else, set intStart to
min (intStart, size). - If length is
undefined , let intLength be size; otherwise let intLength be ?ToIntegerOrInfinity (length). - Set intLength to the result of
clamping intLength between 0 and size. - Let intEnd be
min (intStart + intLength, size). - Return the
substring of S from intStart to intEnd.
This method is intentionally generic; it does not require that its
B.2.2.2 String.prototype.anchor ( name )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"a" ,"name" , name).
B.2.2.2.1 CreateHTML ( string, tag, attribute, value )
The abstract operation CreateHTML takes arguments string (an
- Let str be ?
RequireObjectCoercible (string). - Let S be ?
ToString (str). - Let p1 be the
string-concatenation of"<" and tag. - If attribute is not the empty String, then
- Let V be ?
ToString (value). - Let escapedV be the String value that is the same as
V except that each occurrence of the code unit 0x0022
(QUOTATION MARK) in V has been replaced with the six code
unit sequence
""" . - Set p1 to the
string-concatenation of:- p1
- the code unit 0x0020 (SPACE)
- attribute
- the code unit 0x003D (EQUALS SIGN)
- the code unit 0x0022 (QUOTATION MARK)
- escapedV
- the code unit 0x0022 (QUOTATION MARK)
- Let V be ?
- Let p2 be the
string-concatenation of p1 and">" . - Let p3 be the
string-concatenation of p2 and S. - Let p4 be the
string-concatenation of p3,"</" , tag, and">" . - Return p4.
B.2.2.3 String.prototype.big ( )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"big" ,"" ,"" ).
B.2.2.4 String.prototype.blink ( )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"blink" ,"" ,"" ).
B.2.2.5 String.prototype.bold ( )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"b" ,"" ,"" ).
B.2.2.6 String.prototype.fixed ( )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"tt" ,"" ,"" ).
B.2.2.7 String.prototype.fontcolor ( colour )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"font" ,"color" , colour).
B.2.2.8 String.prototype.fontsize ( size )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"font" ,"size" , size).
B.2.2.9 String.prototype.italics ( )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"i" ,"" ,"" ).
B.2.2.10 String.prototype.link ( url )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"a" ,"href" , url).
B.2.2.11 String.prototype.small ( )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"small" ,"" ,"" ).
B.2.2.12 String.prototype.strike ( )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"strike" ,"" ,"" ).
B.2.2.13 String.prototype.sub ( )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"sub" ,"" ,"" ).
B.2.2.14 String.prototype.sup ( )
This method performs the following steps when called:
- Let S be the
this value. - Return ?
CreateHTML (S,"sup" ,"" ,"" ).
B.2.2.15 String.prototype.trimLeft ( )
The property
The initial value of the
B.2.2.16 String.prototype.trimRight ( )
The property
The initial value of the
B.2.3 Additional Properties of the Date.prototype Object
B.2.3.1 Date.prototype.getYear ( )
The getFullYear method is preferred for nearly all purposes, because it
avoids the “year 2000 problem.”
This method performs the following steps when called:
- Let dateObject be the
this value. - Perform ?
RequireInternalSlot (dateObject, [[DateValue]]). - Let t be dateObject.[[DateValue]].
- If t is
NaN , returnNaN . - Return
YearFromTime (LocalTime (t)) -1900 𝔽.
B.2.3.2 Date.prototype.setYear ( year )
The setFullYear method is preferred for nearly all purposes, because it
avoids the “year 2000 problem.”
This method performs the following steps when called:
- Let dateObject be the
this value. - Perform ?
RequireInternalSlot (dateObject, [[DateValue]]). - Let t be dateObject.[[DateValue]].
- Let y be ?
ToNumber (year). - If t is
NaN , set t to+0 𝔽; otherwise, set t toLocalTime (t). - Let yyyy be
MakeFullYear (y). - Let d be
MakeDay (yyyy,MonthFromTime (t),DateFromTime (t)). - Let date be
MakeDate (d,TimeWithinDay (t)). - Let u be
TimeClip (UTC (date)). - Set dateObject.[[DateValue]] to u.
- Return u.
B.2.3.3 Date.prototype.toGMTString ( )
The toUTCString method is preferred. This method is provided principally
for compatibility with old code.
The initial value of the
B.2.4 Additional Properties of the RegExp.prototype Object
B.2.4.1 RegExp.prototype.compile ( pattern, flags )
This method performs the following steps when called:
- Let O be the
this value. - Perform ?
RequireInternalSlot (O, [[RegExpMatcher]]). - If pattern
is an Object and pattern has a [[RegExpMatcher]] internal slot, then- If flags is not
undefined , throw aTypeError exception. - Let P be pattern.[[OriginalSource]].
- Let F be pattern.[[OriginalFlags]].
- If flags is not
- Else,
- Let P be pattern.
- Let F be flags.
- Return ?
RegExpInitialize (O, P, F).
This method completely reinitializes the
B.3 Other Additional Features
B.3.1 Labelled Function Declarations
Prior to ECMAScript 2015, the specification of
-
It is a Syntax Error if any source text that is
strict mode code is matched by this production.
The
B.3.2 Block-Level Function Declarations Web Legacy Compatibility Semantics
Prior to ECMAScript 2015, the ECMAScript specification did not define the occurrence of a
-
A function is declared and only referenced within a single block.
-
One or more
FunctionDeclaration s whoseBindingIdentifier is the name f occur within the function code of an enclosing function g and that declaration is nested within aBlock . -
No other declaration of f that is not a
vardeclaration occurs within the function code of g. -
All occurrences of f as an
IdentifierReference are within theStatementList of theBlock containing the declaration of f.
-
One or more
-
A function is declared and possibly used within a single
Block but also referenced by an inner function definition that is not contained within that sameBlock .-
One or more
FunctionDeclaration s whoseBindingIdentifier is the name f occur within the function code of an enclosing function g and that declaration is nested within aBlock . -
No other declaration of f that is not a
vardeclaration occurs within the function code of g. -
There may be occurrences of f as an
IdentifierReference within theStatementList of theBlock containing the declaration of f. -
There is at least one occurrence of f as an
IdentifierReference within another function h that is nested within g and no other declaration of f shadows the references to f from within h. - All invocations of h occur after the declaration of f has been evaluated.
-
One or more
-
A function is declared and possibly used within a single block but also referenced within subsequent blocks.
-
One or more
FunctionDeclaration whoseBindingIdentifier is the name f occur within the function code of an enclosing function g and that declaration is nested within aBlock . -
No other declaration of f that is not a
vardeclaration occurs within the function code of g. -
There may be occurrences of f as an
IdentifierReference within theStatementList of theBlock containing the declaration of f. -
There is at least one occurrence of f as an
IdentifierReference within the function code of g that lexically follows theBlock containing the declaration of f.
-
One or more
The first use case is interoperable with the semantics of
ECMAScript 2015 interoperability for the second and third use cases requires the following
extensions to the clause
If an ECMAScript implementation has a mechanism for reporting diagnostic warning messages, a
warning should be produced when code contains a
B.3.2.1 Changes to FunctionDeclarationInstantiation
During
- If strict is
false , then- For each
FunctionDeclaration f that is directly contained in theStatementList of anyBlock ,CaseClause , orDefaultClause x such that codeContains x istrue , do- Let F be the
StringValue of theBindingIdentifier of f. - If replacing the
FunctionDeclaration f with aVariableStatement that has F as aBindingIdentifier would not produce any Early Errors for func and parameterNames does not contain F, then- NOTE: A var binding for F is only instantiated
here if it is neither a VarDeclaredName, the name of a
formal parameter, or another
FunctionDeclaration . - If instantiatedVarNames does not contain
F and F is not
"arguments" , then- Perform
! varEnv.CreateMutableBinding(F,
false ). - Perform
! varEnv.InitializeBinding(F,
undefined ). - Append F to instantiatedVarNames.
- Perform
! varEnv.CreateMutableBinding(F,
- When the
FunctionDeclaration f is evaluated, perform the following steps in place of theFunctionDeclaration Evaluation algorithm provided in15.2.6 :- Let fEnv be the
running execution context 's VariableEnvironment. - Let bEnv be the
running execution context 's LexicalEnvironment. - Let fObj be
! bEnv.GetBindingValue(F,
false ). - Perform
! fEnv.SetMutableBinding(F,
fObj,
false ). - Return
unused .
- Let fEnv be the
- NOTE: A var binding for F is only instantiated
here if it is neither a VarDeclaredName, the name of a
formal parameter, or another
- Let F be the
- For each
B.3.2.2 Changes to GlobalDeclarationInstantiation
During
- Perform the following steps:
- Let strict be
ScriptIsStrict of script. - If strict is
false , then- Let declaredFunctionOrVarNames be the
list-concatenation of declaredFunctionNames and declaredVarNames. - For each
FunctionDeclaration f that is directly contained in theStatementList of anyBlock ,CaseClause , orDefaultClause x such that scriptContains x istrue , do- Let F be the
StringValue of theBindingIdentifier of f. - If replacing the
FunctionDeclaration f with aVariableStatement that has F as aBindingIdentifier would not produce any Early Errors for script, then- If
HasLexicalDeclaration (env, F) isfalse , then- Let fnDefinable be
?
CanDeclareGlobalVar (env, F). - If fnDefinable is
true , then- NOTE: A var binding for F
is only instantiated here if it is
neither a VarDeclaredName nor the
name of another
FunctionDeclaration . - If
declaredFunctionOrVarNames
does not contain F, then
- Perform ?
CreateGlobalVarBinding (env, F,false ). - Append F to declaredFunctionOrVarNames.
- Perform ?
- When the
FunctionDeclaration f is evaluated, perform the following steps in place of theFunctionDeclaration Evaluation algorithm provided in15.2.6 :- Let gEnv be the
running execution context 's VariableEnvironment. - Let bEnv be the
running execution context 's LexicalEnvironment. - Let fObj be
! bEnv.GetBindingValue(F,
false ). - Perform ? gEnv.SetMutableBinding(F,
fObj,
false ). - Return
unused .
- Let gEnv be the
- NOTE: A var binding for F
is only instantiated here if it is
neither a VarDeclaredName nor the
name of another
- Let fnDefinable be
?
- If
- Let F be the
- Let declaredFunctionOrVarNames be the
- Let strict be
B.3.2.3 Changes to EvalDeclarationInstantiation
During
- If strict is
false , then- Let declaredFunctionOrVarNames be the
list-concatenation of declaredFunctionNames and declaredVarNames. - For each
FunctionDeclaration f that is directly contained in theStatementList of anyBlock ,CaseClause , orDefaultClause x such that bodyContains x istrue , do- Let F be the
StringValue of theBindingIdentifier of f. - If replacing the
FunctionDeclaration f with aVariableStatement that has F as aBindingIdentifier would not produce any Early Errors for body, then- Let bindingExists be
false . - Let thisEnv be lexEnv.
Assert : The following loop will terminate.- Repeat, while thisEnv is not varEnv,
- If thisEnv
is not an Object Environment Record , then- If
! thisEnv.HasBinding(F)
is
true , then-
Let bindingExists be
true .
-
Let bindingExists be
- If
! thisEnv.HasBinding(F)
is
- Set thisEnv to thisEnv.[[OuterEnv]].
- If thisEnv
- If bindingExists is
false and varEnv is aGlobal Environment Record , then- If
HasLexicalDeclaration (varEnv, F) isfalse , then- Let fnDefinable be
?
CanDeclareGlobalVar (varEnv, F).
- Let fnDefinable be
?
- Else,
- Let fnDefinable be
false .
- Let fnDefinable be
- If
- Else,
- Let fnDefinable be
true .
- Let fnDefinable be
- If bindingExists is
false and fnDefinable istrue , then- If declaredFunctionOrVarNames does not
contain F, then
- If varEnv is a
Global Environment Record , then- Perform ?
CreateGlobalVarBinding (varEnv, F,true ).
- Perform ?
- Else,
- Let bindingExists be ! varEnv.HasBinding(F).
- If bindingExists is
false , then- Perform
! varEnv.CreateMutableBinding(F,
true ). - Perform
! varEnv.InitializeBinding(F,
undefined ).
- Perform
! varEnv.CreateMutableBinding(F,
- Append F to declaredFunctionOrVarNames.
- If varEnv is a
- When the
FunctionDeclaration f is evaluated, perform the following steps in place of theFunctionDeclaration Evaluation algorithm provided in15.2.6 :- Let gEnv be the
running execution context 's VariableEnvironment. - Let bEnv be the
running execution context 's LexicalEnvironment. - Let fObj be
! bEnv.GetBindingValue(F,
false ). - Perform ? gEnv.SetMutableBinding(F,
fObj,
false ). - Return
unused .
- Let gEnv be the
- If declaredFunctionOrVarNames does not
contain F, then
- Let bindingExists be
- Let F be the
- Let declaredFunctionOrVarNames be the
B.3.2.4 Changes to Block Static Semantics: Early Errors
The rules for the following production in
-
It is a Syntax Error if the
LexicallyDeclaredNames ofStatementList contains any duplicate entries, unlessIsStrict (this production) isfalse and the duplicate entries are only bound by FunctionDeclarations. -
It is a Syntax Error if any element of the
LexicallyDeclaredNames ofStatementList also occurs in theVarDeclaredNames ofStatementList .
B.3.2.5 Changes to switch Statement Static
Semantics: Early Errors
The rules for the following production in
-
It is a Syntax Error if the
LexicallyDeclaredNames ofCaseBlock contains any duplicate entries, unlessIsStrict (this production) isfalse and the duplicate entries are only bound by FunctionDeclarations. -
It is a Syntax Error if any element of the
LexicallyDeclaredNames ofCaseBlock also occurs in theVarDeclaredNames ofCaseBlock .
B.3.2.6 Changes to BlockDeclarationInstantiation
During
- If ! env.HasBinding(dn) is
false , then- Perform ! env.CreateMutableBinding(dn,
false ).
- Perform ! env.CreateMutableBinding(dn,
During
- Perform the following steps:
- If the binding for fn in env is an uninitialized
binding, then
- Perform ! env.InitializeBinding(fn, fo).
- Else,
Assert : d is aFunctionDeclaration .- Perform ! env.SetMutableBinding(fn,
fo,
false ).
- If the binding for fn in env is an uninitialized
binding, then
B.3.3 FunctionDeclarations in IfStatement Statement Clauses
The following augments the
This production only applies when parsing
B.3.4 VariableStatements in Catch Blocks
The content of subclause
-
It is a Syntax Error if the
BoundNames ofCatchParameter contains any duplicate elements. -
It is a Syntax Error if any element of the
BoundNames ofCatchParameter also occurs in theLexicallyDeclaredNames ofBlock . -
It is a Syntax Error if any element of the
BoundNames ofCatchParameter also occurs in theVarDeclaredNames ofBlock unlessCatchParameter isCatchParameter : BindingIdentifier
The var declarations that bind a name that is also bound by the var declarations will assign to the corresponding catch parameter rather
than the var binding.
This modified behaviour also applies to var and function declarations
introduced by
Step
- If thisEnv is not the
Environment Record for aCatch clause, throw aSyntaxError exception.
Step
- If thisEnv is not the
Environment Record for aCatch clause, let bindingExists betrue .
B.3.5 Initializers in ForIn Statement Heads
The following augments the
This production only applies when parsing
The
- Return
ContainsDuplicateLabels ofStatement with argument labelSet.
The
- Return
ContainsUndefinedBreakTarget ofStatement with argument labelSet.
The
- Return
ContainsUndefinedContinueTarget ofStatement with arguments iterationSet and « ».
The
- Return
false .
The
- Let names1 be the
BoundNames ofBindingIdentifier . - Let names2 be the
VarDeclaredNames ofStatement . - Return the
list-concatenation of names1 and names2.
The
- Let declarations1 be «
BindingIdentifier ». - Let declarations2 be the
VarScopedDeclarations ofStatement . - Return the
list-concatenation of declarations1 and declarations2.
The
- Let bindingId be the
StringValue ofBindingIdentifier . - Let lhs be ?
ResolveBinding (bindingId). - If
IsAnonymousFunctionDefinition (Initializer ) istrue , then- Let value be ?
NamedEvaluation ofInitializer with argument bindingId.
- Let value be ?
- Else,
- Let rhs be ?
Evaluation ofInitializer . - Let value be ?
GetValue (rhs).
- Let rhs be ?
- Perform ?
PutValue (lhs, value). - Let keyResult be ?
ForIn/OfHeadEvaluation (« »,Expression ,enumerate ). - Return ?
ForIn/OfBodyEvaluation (BindingIdentifier ,Statement , keyResult,enumerate ,var-binding , labelSet).
B.3.6 The [[IsHTMLDDA]] Internal Slot
An [[IsHTMLDDA]] internal slot may exist on
typeof operator
Objects with an [[IsHTMLDDA]] internal slot are never created by
this specification. However, the document.all
object in web browsers is a document.all.
B.3.6.1 Changes to ToBoolean
The following step replaces step
- If argument
is an Object and argument has an [[IsHTMLDDA]] internal slot, returnfalse .
B.3.6.2 Changes to IsLooselyEqual
The following steps replace step
- Perform the following steps:
- If x
is an Object , x has an [[IsHTMLDDA]] internal slot, and y is eitherundefined ornull , returntrue . - If x is either
undefined ornull , yis an Object , and y has an [[IsHTMLDDA]] internal slot, returntrue .
- If x
B.3.6.3 Changes to the typeof Operator
The following step replaces step typeof
- If val has an [[IsHTMLDDA]] internal slot,
return
"undefined" .
B.3.7 Non-default behaviour in HostMakeJobCallback
The
B.3.8 Non-default behaviour in HostEnsureCanAddPrivateElement
The
Annex C (informative) The Strict Mode of ECMAScript
The strict mode restriction and exceptions
-
implements,interface,let,package,private,protected,public,static, andyieldarereserved words withinstrict mode code . (12.7.2 ). -
A conforming implementation, when processing
strict mode code , must disallow instances of the productionsNumericLiteral :: LegacyOctalIntegerLiteral DecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral -
A conforming implementation, when processing
strict mode code , must disallow instances of the productionsEscapeSequence :: LegacyOctalEscapeSequence EscapeSequence :: NonOctalDecimalEscapeSequence -
Assignment to an undeclared identifier or otherwise unresolvable reference does not create a
property in the
global object . When a simple assignment occurs withinstrict mode code , itsLeftHandSideExpression must not evaluate to an unresolvable Reference. If it does aReferenceError exception is thrown (6.2.5.6 ). TheLeftHandSideExpression also may not be a reference to adata property with the attribute value { [[Writable]]:false }, to anaccessor property with the attribute value { [[Set]]:undefined }, nor to a non-existent property of an object whose [[Extensible]] internal slot isfalse . In these cases aTypeErrorexception is thrown (13.15 ). -
An
IdentifierReference with theStringValue "eval" or"arguments" may not appear as theLeftHandSideExpression of an Assignment operator (13.15 ) or of anUpdateExpression (13.4 ) or as theUnaryExpression operated upon by a Prefix Increment (13.4.4 ) or a Prefix Decrement (13.4.5 ) operator. -
Arguments objects for
strict functions define a non-configurableaccessor property "callee" which throws aTypeError exception on access (10.4.4.6 ). -
Arguments objects for
strict functions do not dynamically share theirarray-indexed property values with the corresponding formal parameter bindings of their functions. (10.4.4 ). -
For
strict functions , if an arguments object is created the binding of the local identifierargumentsto the arguments object is immutable and hence may not be the target of an assignment expression. (10.2.11 ). -
It is a
SyntaxError if theStringValue of aBindingIdentifier is either"eval" or"arguments" withinstrict mode code (13.1.1 ). -
Strict mode eval code cannot instantiate variables or functions in the variable environment of the
caller to eval. Instead, a new variable environment is created and that environment is used for
declaration binding instantiation for the eval code (
19.2.1 ). -
If
this is evaluated withinstrict mode code , then thethis value is not coerced to an object. Athis value of eitherundefined ornull is not converted to theglobal object and primitive values are not converted to wrapper objects. Thethis value passed via a function call (including calls made usingFunction.prototype.applyandFunction.prototype.call) do not coerce the passedthis value to an object (10.2.1.2 ,20.2.3.1 ,20.2.3.3 ). -
When a
deleteoperator occurs withinstrict mode code , aSyntaxError is thrown if itsUnaryExpression is a direct reference to a variable, function argument, or function name (13.5.1.1 ). -
When a
deleteoperator occurs withinstrict mode code , aTypeError is thrown if the property to be deleted has the attribute { [[Configurable]]:false } or otherwise cannot be deleted (13.5.1.2 ). -
Strict mode code may not include aWithStatement . The occurrence of aWithStatement in such a context is aSyntaxError (14.11.1 ). -
It is a
SyntaxError if aCatchParameter occurs withinstrict mode code and theBoundNames ofCatchParameter contains eitherevalorarguments(14.15.1 ). -
It is a
SyntaxError if the sameBindingIdentifier appears more than once in theFormalParameters of astrict function . An attempt to create such a function using a Function, Generator, or AsyncFunctionconstructor is aSyntaxError (15.2.1 ,20.2.1.1.1 ). -
An implementation may not extend, beyond that defined in this specification, the meanings within
strict functions of properties named"caller" or"arguments" of function instances.
Annex D (informative) Host Layering Points
See
D.1 Host Hooks
D.2 Host-defined Fields
[[HostDefined]] on
[[HostDefined]] on
[[HostDefined]] on
[[HostDefined]] on
[[HostSynchronizesWith]] on Candidate Executions: See
[[IsHTMLDDA]]: See
D.3 Host-defined Objects
The
D.4 Running Jobs
Preparation steps before, and cleanup steps after, invocation of
D.5 Internal Methods of Exotic Objects
Any of the essential internal methods in
D.6 Built-in Objects and Methods
Any built-in objects and methods not defined within this specification, except as restricted in
Annex E (informative) Corrections and Clarifications in ECMAScript 2015 with Possible Compatibility Impact
Date.prototype.toString when the
/.
String.prototype.match and String.prototype.replace was
incorrect for cases where the pattern argument was a RegExp value whose global flag is set.
The previous specifications stated that for each attempt to match the pattern, if lastIndex
did not change, it should be incremented by 1. The correct behaviour is that lastIndex
should be incremented by 1 only if the pattern matched the empty String.
Array.prototype.sort. ECMAScript 2015 specifies that such as value is treated as if
Annex F (informative) Additions and Changes That Introduce Incompatibilities with Prior Editions
Space_Separator (Zs) category and thus treated as whitespace in ECMAScript
2015, to be moved to the Format (Cf) category (as of Unicode 6.3.0). This
causes whitespace-sensitive methods to behave differently. For example,
"\u180E".trim().length was 0 in previous editions, but 1 in
ECMAScript 2016 and later. Additionally, ECMAScript 2017 mandated always using the latest version of the
Unicode Standard.
let followed by the token [ is the start of a
(
token of a for statement is immediately followed by the token sequence let [ then the
let is treated as the start of a
let [ then the
let is treated as the start of a
in
var declaration for the same
eval
whose eval code includes a var or FunctionDeclaration declaration that binds
the same
Object.freeze is not an object it is treated as if
it was a non-extensible
Object.getOwnPropertyDescriptor is not an object an attempt is made to coerce
the argument using
Object.getOwnPropertyNames is not an object an attempt is made to coerce the
argument using
Object.getPrototypeOf is not an object an attempt is made to coerce the argument using
Object.isExtensible is not an object it is treated as if it was a non-extensible
Object.isFrozen is not an object it is treated as if it was a non-extensible
Object.isSealed is not an object it is treated as if it was a non-extensible
Object.keys is not an object an attempt is made to
coerce the argument using
Object.preventExtensions is not an object it is treated as if it was a
non-extensible
Object.seal is not an object it is treated as if it was
a non-extensible
String.prototype.localeCompare function must treat Strings that are canonically equivalent
according to the Unicode Standard as being identical. In previous editions implementations were
permitted to ignore canonical equivalence and could instead use a bit-wise comparison.
String.prototype.trim method is defined to recognize white space code points that may exist
outside of the Unicode BMP. However, as of Unicode 7 no such code points are defined. In previous
editions such code points would not have been recognized as white space.
Atomics.wake has been renamed to Atomics.notify to prevent
confusion with Atomics.wait.
await
was reduced, which could create an observable difference in resolution order between a
then() call and an await expression.
Bibliography
-
IEEE 754-2019: IEEE Standard for Floating-Point Arithmetic.
Institute of Electrical and Electronic Engineers, New York (2019)
Note There are no normative changes between IEEE 754-2008 and IEEE 754-2019 that affect the ECMA-262 specification.
- The Unicode Standard, available at <https://unicode.org/versions/latest>
- Unicode Technical Note #5: Canonical Equivalence in Applications, available at <https://unicode.org/notes/tn5/>
- Unicode Technical Standard #10: Unicode Collation Algorithm, available at <https://unicode.org/reports/tr10/>
- Unicode Standard Annex #15, Unicode Normalization Forms, available at <https://unicode.org/reports/tr15/>
- Unicode Standard Annex #18: Unicode Regular Expressions, available at <https://unicode.org/reports/tr18/>
-
Unicode Standard Annex #24: Unicode
ScriptProperty, available at <https://unicode.org/reports/tr24/> - Unicode Standard Annex #31, Unicode Identifiers and Pattern Syntax, available at <https://unicode.org/reports/tr31/>
- Unicode Standard Annex #44: Unicode Character Database, available at <https://unicode.org/reports/tr44/>
- Unicode Technical Standard #51: Unicode Emoji, available at <https://unicode.org/reports/tr51/>
- IANA Time Zone Database, available at <https://www.iana.org/time-zones>
- ISO 8601:2004(E) Data elements and interchange formats — Information interchange — Representation of dates and times
- RFC 1738 “Uniform Resource Locators (URL)”, available at <https://tools.ietf.org/html/rfc1738>
- RFC 2396 “Uniform Resource Identifiers (URI): Generic Syntax”, available at <https://tools.ietf.org/html/rfc2396>
- RFC 3629 “UTF-8, a transformation format of ISO 10646”, available at <https://tools.ietf.org/html/rfc3629>
- RFC 7231 “Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content”, available at <https://tools.ietf.org/html/rfc7231>
Colophon
This specification is authored on GitHub in a plaintext source format called Ecmarkup. Ecmarkup is an HTML and Markdown dialect that provides a framework and toolset for authoring ECMAScript specifications in plaintext and processing the specification into a full-featured HTML rendering that follows the editorial conventions for this document. Ecmarkup builds on and integrates a number of other formats and technologies including Grammarkdown for defining syntax and Ecmarkdown for authoring algorithm steps. PDF renderings of this specification are produced using a print stylesheet which takes advantage of the CSS Paged Media specification and is converted using PrinceXML.
Prior editions of this specification were authored using Word—the Ecmarkup source text that formed the basis of this edition was produced by converting the ECMAScript 2015 Word document to Ecmarkup using an automated conversion tool.
Copyright & Software License
Ecma International
Rue du Rhone 114
CH-1204 Geneva
Tel: +41 22 849 6000
Fax: +41 22 849 6001
Web: https://ecma-international.org/
Copyright Notice
© 2025 Ecma International
This draft document may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published, and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this section are included on all such copies and derivative works. However, this document itself may not be modified in any way, including by removing the copyright notice or references to Ecma International, except as needed for the purpose of developing any document or deliverable produced by Ecma International.
This disclaimer is valid only prior to final version of this document. After approval all rights on the standard are reserved by Ecma International.
The limited permissions are granted through the standardization phase and will not be revoked by Ecma International or its successors or assigns during this time.
This document and the information contained herein is provided on an "AS IS" basis and ECMA INTERNATIONAL DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Software License
All Software contained in this document ("Software") is protected by copyright and is being made available under the "BSD License", included below. This Software may be subject to third party rights (rights from parties other than Ecma International), including patent rights, and no licenses under such third party rights are granted under this license even if the third party concerned is a member of Ecma International. SEE THE ECMA CODE OF CONDUCT IN PATENT MATTERS AVAILABLE AT https://ecma-international.org/memento/codeofconduct.htm FOR INFORMATION REGARDING THE LICENSING OF PATENT CLAIMS THAT ARE REQUIRED TO IMPLEMENT ECMA INTERNATIONAL STANDARDS.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
- Neither the name of the authors nor Ecma International may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE ECMA INTERNATIONAL "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ECMA INTERNATIONAL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.